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ivianual Conventions 



The manual conventions and syntax conventions used in this book are presented below. For 
a full understanding of information in this manual, review the following conventions. 



underlining Where it is necessary to distinguish user input from computer output, 

the input is underlined. 

1^ j Dashed line key symbols indicate a soft key on the keyboard. The 

physical labels for the soft keys appear on the CRT display. In text, the 
soft key label will appear within the symbol. 

Tl 

; Solid outlined key symbols are used in text to represent labeled keys 

R 

^ on the keyboard. 

[ ] Parameters enclosed in square brackets are optional. Several 

parameters stacked inside a set of brackets indicate an either/or 
situation. You may select any one or none of the parameters. 

The use of square brackets implies that a default value exists. 

Example: 



B 

This indicates A or B may be selected. 



{ } Braces specify that the parameter enclosed is required information. 

When several parameters are stacked within a set of braces, you must 
select one and only one of the parameters. 



Example: 



This example says one and only one of A, B, or C must be 
selected. 

Choice of one and only one when several elements are enclosed. 



Ill 



Manual Conventions (Cont'd) 



[ ] stacked square brackets indicate that enclosed parameters are 

[ 1 optional and may be selected in any single occurrence, any 

combination, or may be omitted. 



lower-case 
bold type 



Example: 

[A] 
[ B ] 
[ C] 

A and/or B and/or C may be selected, or this option may be omitted. 

Angle brackets denote frequently used syntax elements which are 
predefined. 

Key words (soft key commands) are lower-case in the Model 64000. 
These key words will always be represented in text with lower-case 
bold type. 

Example: 

edit <FILE> 



=> 



Arrow indicated "is defined as. 



• ■ ■ An ellipsis indicates a previous bracketed element can be repeated. 

UPPER-CASE Literal information which is supplied in a command is represented in 
text with upper case type. 



Syntax symbols Indicates symbols are used for definition purposes and do not appear 
in color on the CRT display. 
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Chapter ± 

Installation 



Hardware Configuration 

Information regarding the installation and configuration of emulation and analysis modules 
into the 641 OOA and 6411 OA systems, including power requirements and cabling, is found in 
the Installation and Configuration Reference Manual. Pay particular attention to power 
requirements when configuring multi-module systems. 

Set the work station power switch to "off". 

Unpack all emulation circuit boards, cables, pods and related equipment. Compare the parts 
received with the parts list to assure that all necessary items have been shipped. If any 
equipment is missing, contact the nearest Hewlett-Packard Sales/Service Office as soon as 
possible. 

Carefully inspect the equipment for damage that may have occurred during shipping. 

NOTE 



The following installation steps assume the installation of a 
complete system (maximum memory). Particular attention 
should be paid to the power requirements for multi-module 
systems. Disregard procedure steps for equipment you have 
not purchased. 
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While the emulation and analysis circuit boards may be installed in any card slot in the 
station chassis, mechanical considerations make the following card groupings most 
convenient: 

For single module systems: 



slot slot 

number number 

board 641 OOA 6411 OA 

Emulation Control board 9 0 

Analysis board (optional) 8 1 

Memory Control board (optional) 7 2 

Memory board (optional) 6 3 
Memory board (optional) 5 



For multi-module systems: 



board 



slot 
number 
641 OOA 



slot 
number 
6411 OA 



Memory board (optional) 
Memory board (optional) 
Memory Control board (optional) 
Emulation Control board 
Internal Analysis board (optional) 

Internal Analysis board (optional) 
Emulation Control board 
Memory Control board (optional) 
Memory board (optional) 
Memory board (optional) 



9 
8 
7 
6 
5 

4 
3 
2 
1 
0 



0 
1 

2 
3 



When an emulator is used in a system with state or timing analyzers, either half of the above 
ordering may be used. 

Installation of the circuit boards is accomplished by aligning each circuit card in the circuit 
card guides, with the component side of the board facing forward, or up for the 641 10A, and 
applying a gentle pressure until the board is seated in the mother board connector. Be sure 
the ejector handles are in their fully horizontal position. 
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Installing the Emulation Pod and Emulation Control 

Board 



For emulation of a 6809 series microprocessor (6809, 68A09, 68B09), the model 6421 5A 
emulator pod is required. For emulation of a 6809E series microprocessor (6809E, 68A09E, 
68B09E), the model 6421 6A emulator pod is required. 

The 64214A Emulation Control board can be used with both the 6809 series processors and 
the 6809E series processors. 

Two multi-colored ribbon cables are used to connect the emulation pod to the emulation 
control board. One of the cables is connected to a surface-mounted connector, and one 
cable is connected to the top edge of the emulation control board. Pin 1 on the cable 
connectors is indicated by a triangle molded into each connector. Pin 1 of the board- 
mounted connectors is located at the left end of each connector. The surface-mounted 
connector is located near the top left corner of the Emulation Control board (on the 
component side). The edge connector is located at the left, near the surface mounted 
connector. Proper connection is facilitated by the color coding and keying of the connectors. 
Connect the pod to the control board by joining the connectors. 

Install the Emulation Control board into the station chassis to maximize the free cable length 
outside the work station chassis, for single module systems. 



PROTECT AGAINST STATIC DISCHARGE 



The emulator pod contains devices that are susceptible to 
damage by static discharge. Therefore, operators should take 
precautionary measures before handling the user plug to 
avoid emulator damage. 



Installing Emulation Probe To Target System 



Carefully remove the target processor from its socket, and place the processor into a 
protected area. Then install the emulation probe into the vacant socket. 
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CAUTION 



Do not install the emulation probe into the processor socket 
with power applied to the target system. The pod may be 
damaged if power is not removed before installation. 



The 6809E emulation control cable is covered by a black shield that must be connected to the 
64000 chassis ground. Refer to the 6809E service manual for the installation procedure. 

The emulation probe is provided with a pin protector that prevents damage to the probe when 
connecting and removing the probe from the microprocessor socket. DO NOT use the probe 
without a pin protector installed. If the emulation probe is being installed on a densely 
populated circuit board there may not be enough room to accomodate the plastic shoulders 
of the probe socket. If this occurs, another pin protector may be stacked onto the existing pin 
protector. The short wire extending from the emulation probe may be connected to the target 
system signal ground. 

When installing the emulation probe, be sure the probe is inserted into the processor socket 
so that the red edge of the cable aligns with the pin 1 end of the processor socket as shown in 
figure 1-1. Damage to the emulation equipment may result if the probe is incorrectly 
installed. 



RED STRIPE AND 
PIN 1 MUST BE 
IN ALIGNMENT. 



RED 
STRIPE 



PIN 1 



CABLE 



EMULATION 
PROBE 



40 PIN EXTENDER 

II II I 1 1 1 1 I I m 1 



PROCESSOR SOCKET 



(target system) 



AT LEAST ONE IS REQUIRED 



POWER TO PROCESSOR 
SOCKET MUST BE OFF! 



Figure 1-1. Installing the Emulation Probe 
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Installing the Analysis Board 



Single Module Systems 

Install the Analysis board in the next slot adjacent to the Emulation Control board. For 
example, if the Emulation Control board was installed in slot 9, the Analysis board should be 
installed in slot 8. The board is installed with the component side facing the front of the work 
station. Avoid scuffing the emulation control cables when installing the Analysis board by 
ensuring that the cables are as flat as possible against the emulation control board. 

Multiple Module Systems 

Install the internal analysis boards between the emulation control boards. 

Installing the Memory Control Board 

The memory control board and memory boards are not required if only target system 
memory is to be used. 

Set the data bits switch and address bus width cable to their correct positions before 
installing the memory control board. 

The data bits switch, located between the J2 and J3 edge connectors, should be set to select 
a data bus of eight bits (switch moved to the left). Figure 1-2 shows the data bus switch in the 
correct position. 

The address bus width is selected by positioning the ribbon cable, located at the board 
center, for a bus width of 16 bits. Figure 1-2 shows the cable position for a 16 bit address bus. 

Single Module Systems 

The memory control board is installed in the next vacant slot, adjacent to the analysis board. 
If no analysis board is used, memory control may be installed in the slot next to the emulation 
control board, or, leaving a slot vacant where the analysis board would normally be placed, in 
a position two slots away from the emulation control board. As with the emulation control 
board, install the memory control board, with the component side forward, or up, with a 
gentle pressure until firmly seated in the mother board connector. 

Multiple Module Systems 

The memory control boards should be installed outside of the emulation control boards, i.e., 
one should be in front of the front emulation control board and one should be behind the rear 
emulation control board. 
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There is room for only one memory controller in the 64110A card cage if a dual Emulation 
and dual Analysis configuration is installed. 




Figure 1-2. Memory Control Board 
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Installing the Memory Boards 



Memory boards in the model 6415X series may contain from 4K to 16K words (8K to 32K 
bytes) of random access memory (RAIVI). Tine logical address of each board must be specified 
by installing an 8-pin jumper plug in socket U11. U11 is located near the upper right corner, 
and is adjacent to label boxes indicating address range options (see figure 1-3). The address 
range is selected by installing the 8-pin jumper plug into the half of the socket (U11) 
associated with the address range being selected. The address range selection is used only 
to distinguish one memory board from another for the emulation and analysis system, and 
not to establish addresses for emulation. The address range may be split. For example, 0 to 
16K and 48K to 64K may be found on the same board. 

Memory boards in the model 6416X series may contain from 32K to 128K bytes of random 
access memory. Refer to the 641 6X series service manual for the necessary configuration 
and installation procedures. 

Address range specifications for the 641 5X series memory boards are listed below: 

a. Address range specification does not limit the address ranges which may be emulated. 

b. No two memory boards, connected to the same memory controller, may be specified 
as the same address range. 

c. Two positions are available for address range selection for 8 bit emulation. One full or 
partially loaded board must be set to 0 to 16K words address range. 

d. A maximum of two boards may be connected to a memory controller for 6809/6809E 
emulation processors. Refer to the Installation and Configuration Reference Manual 
for maximum allowable memory. 

Single Module Systems 

Install the Memory boards in the slots adjacent to the Memory Control board. The boards are 
installed with the component side facing the front, or top, of the work station. Be sure that the 
boards are firmly seated in the mother board connector. 

Multiple Module Systems 

Install the memory boards outside of the memory control boards. The memory boards should 
be the boards closest to the front and to the rear (bottom and top) of the card cage. 
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Figure 1-3. Address Range Selection Socitets 

Installing the Bus Cables 

Bus cable installation should take place after installation of the circuit boards has been 
completed. See figure 1-4 for the cable configuration for a complete system, including the 
intermodule bus if a multi-module system has been installed. 

The two cables in the center and on the right of the circuit board set are the EMULATION bus 
cables. The connectors are keyed to facilitate correct installation. The connectors are also 
color coded, with the coding placed to the left end of each connector over pin 1. Each 
connector has a triangle indicator molded into the connector to indicate the location of pin 1 
side and end in the connector. When properly installed, the red marker of the bus cable is on 
the left hand side of the cable when viewed from above the card cage. Two cables, each 
having three female connector blocks, are installed on the Emulation Control board, the 
Analysis board, and Memory Control board. 
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The Memory bus cable is on the left hand side of the board set, as you face the front of the 
work station. The Memory Control board is joined to the Memory boards by a cable with 
three connectors similar to the emulation bus cables. The connectors are color coded and 
keyed to facilitate proper installation, with the color coding placed to the left end of the 
connector. Each connector has a triangle indicator molded into the connector to indicate the 
location of pin 1 side and end in the connector. When properly installed, the red marker strip 
will be on the left of the ribbon cable as you look down on the card cage from the front of the 
work station. 

The intermodule bus consists of a 20 conductor ribbon cable that is installed on the upper left 
corner of the appropriate board in each module. For emulation modules, connection is made 
to the internal analysis boards; for analyzer modules, connection is made to the analysis 
control boards. 




EMULATION BUS 



Figure 1-4. Memory, Emulation, and Intermoduie Bus Cabiing 

Figure 1-4 shows the cable placement in a 64100A card cage. The relative cable placement in 
a 64110A card cage is the same, although the card cage is rotated 90 degrees to the 
horizontal. 
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Chapter 

Theory of Operation 



Introduction 

The basic system consists of a logic development station having a magnetic tape drive or 
flexible mini disc drive, a hard disc and printer, and software modules to edit, assemble or 
compile, link, and store program modules. 

System Bus Structures 

The 64000 system is designed with multiple independent buses for the host environment and 
emulator subsystem. Since the host processor and the emulation systems operate on 
separate buses, both can be running at the same time with no contention for system 
resources. Figure 2-1 illustrates the 64000 Logic Development Station bus orientation. The 
five basic bus structures for the 64000 are briefly described in the following paragraphs. 

System Bus The address, data, and control buses for the 64000 system are 

included in the system (HP-IB) bus. Communication between the 
printer, hard disc, and development stations occurs via the system 
bus. 

Emulation Bus The address, data, and control buses for the emulator processor 

are included in the emulation bus. Communication between the 
emulation controller, analysis module, and the target system takes 
place through the emulation bus. 

Host Processor Bus The host processor bus is the path through which the host 
processor communicates with the emulation and analysis 
subsystem, the display, and host processor memory. 
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I/O Bus The Input/Output bus is dedicated to input and output devices of 

the 64000 station. It handles data to and from the minicartridge 
tape drive, the flexible disc drives, the keyboard, the hard disc 
drive, the printer, and the system processor. 

Intermodule Bus The intermodule bus connects the appropriate control boards in a 
multi-module system and carries signals related to sequence, 
timing, and triggering between the modules. 

All data transfers in the emulation system occur on the buses described above. 

For example, to display user RAM memory, a command is transmitted on the host processor 
bus from the host processor to the emulation control board. The Emulation Control board 
obtains the desired information through the emulation bus from the target system memory. 
The host processor then obtains the data from the emulation control board via the host 
processor bus. From there the data is passed to the display controller for display on the CRT. 
To display emulation memory, data in emulation memory is accessed by the host processor 
through the memory control board via the host processor bus. From that point on, data is 
transferred to the display. 
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Figure 2-1. 64000 Logic Deveiopment System Simpiified 
Functionai Bloci( Diagram 

The architecture of the multi-module system, illustrated in figure 2-1, allows monitoring of 
the emulation processor without interfering with its operation. In addition, because the 
emulation bus is independent from the host processor bus, it is possible for emulation to 
continue while the development station is used for other purposes. 
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A major advantage of this architecture is the expandability of emulation systems. Since the 
host processing system does not restrict the word length or the speed of emulators 
connected tothe host system, the system is capable of handling future as well as current 
microprocessors. 

Emulation and Analysis Subsystem Functional 

Description 

A complete emulation and analysis subsystem consists of an emulation pod, emulation 
probe, emulation control board, memory control board, memory board(s), and analysis 
board. A brief description of the subsystem is given in the following paragraphs. 

Subsystem Interfaces 

The interfaces for the emulation and analysis subsystem are the target system interface, 
consisting of the emulation probe and pod, and emulation bus, and the development station 
interface consisting of the host processor bus. 

Target System 

The target system shown as part of figure 2-1, represents a typical system having a 
microprocessor, control circuits, memory (ROM/RAM), and I/O circuits. 

Emulation Controller Functional Description 

in foreground operation the emulation processor (in the emulator pod) functions as the 
processor for the target system. Programs executed by the emulation processor can be 
resident in the target system memory, or emulation memory, or a combination of both. 

In addition, the target system memory can be loaded into emulation memory and the 
program modified. The memory map can be constructed to direct memory accesses to the 
emulation memory. The modified program can then be executed without disturbing the 
original version of the program. 

During operation in the background state, emulation processor operation is suspended in the 
user system with the processor appearing to be inactive. This condition is implemented with 
the control of emulation pod buffers and latches by the background controller which is 
located on the emulation control board. 

Operation of the emulator in the foreground state is exactly like operation of the target 
microprocessor in a normal environment. 
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Functional transparency of the ennulator has been achieved with two features: background 
memory and the associated controller. The associated controller transfers processor control 
between the target system and the host system, i.e., foreground and background, 
respectively. 

Background memory is located on the emulation control board. This memory is a 256 byte 
RAM which is accessible by the emulation processor and the 64000 host procesor. The 
background memory is the primary communication link between the processors. 

The background memory contains the routines for control of target processor execution. 
Routines to read and modify memory and registers and a routine to unload target processor 
registers are supplied by the host processor to the background memory. When the emulator 
changes the operating context of the emulation processor to background, the emulation 
processor will execute the routines in background memory. 

A break to the background memory for the 6809/6809E emulators is accomplished by 
jamming a "Software Interrupt instruction" to the emulation processor, i.e., forcing the 
processor to execute a SWI instruction that makes it dump its registers in known locations in 
BKG (background) memory, and to start executing BKG code. 

Transparency Considerations 

A goal of emulation is that the emulation processor operates functionally and electrically in 
the same way as the target processor, i.e., to be transparent. 

Functional transparency is acheived when an emulator places no restrictions or demands on 
any of the functional operations of the target processor, such as use of interrupts, restriction 
of memory address range, or any other functional characteristics. 

Electrical transparency implies that all timing specifications, electrical loading, logic 
thresholds, drive levels, and any other electrical characteristics of the target processor are 
upheld by the emulator. The term "eletrically identical" is a more accurate definition of 
electrical transparency. 

Unfortunately, in attempting to achieve these goals, some compromises are sometimes 
necessary. Functional transparency cannot be achieved unless the "background activities" 
performed by the emulation system are shielded from the target system. These background 
activities include register interrogation, status checking, detection of illegal opcodes, or 
other operations that may disturb the operating context of the emulation processor. 

The shielding or isolation of emulator background activities from the target system is 
accomplished with buffers and latches. These buffers and latches add propagation delays to 
the emulator which sometimes compromise electrical transparency. 
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The 64000 Logic Development System has been designed to implement functional 
transparency for the current generation of 8-bit emulators. Therefore, users of the 64000 
system can do system design without arbitrary constraint from the emulators but users must 
be aware of the slight propagation delays induced by the emulators. 

Break Conditions 



A break condition initiates the context change of the emulation processor from foreground 
operation to background operation. There are four sources of a break condition: the logic 
analyzer, the emulation memory control board, the emulation control board, and the host 
system. 

A break condition in normal operation is issued when an analyzer trace specification has 
been met, i.e., "break on trigger" or "break on measurement complete" is specified, or as a 
result of keyboard commands to the emulator that stop or single-step the emulation 
processor. 

Detected errors account for break conditions from emulation memory and the emulator 
control board. Emulation memory control issues a break if an access to guarded memory 
occurs, or if a write to ROM occurs. A break condition from the emulator control board will be 
caused if an illegal opcode fetch occurs. 

Other sources of break conditions occur during non real-time operation. Operations, such as 
register access and memory access, that occur during program execution will cause the 
alteration between foreground and background memory. 

Emulation Processor Control 



The technique used by the 64000 emulator for emulation processor control involves jamming 
data inforrilation onto the processor data bus. This data jamming is asserted at the 
appropriate time in the processor instruction cycle to vector the processor operation to a 
control routine contained in the emulator background memory. The jamming process is 
synchronized by the background controller to occur on the first opcode fetch cycle following 
the occurrence of a break condition. 

This technique allows the emulator to gain control of the processor at the earliest possible 
time in the first instruction cycle after a break condition occurs. 
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When the emulator has been changed to background state, the background program causes 
the register values of the processor, the program counter, and the next insruction address to 
be saved. This information is restored to the emulation processor when operation is returned 
to foreground (real-time) state. This allows the processor to continue execution from the 
point at which the break occured when the emulator was in foreground. This process is 
similar to a hardware implementation of a non-maskable interrupt that is independent of the 
processor type. 

The background controller is a state machine consisting of four states: jam background, idle 
background, exit background, and foreground. Figure 2-2 is a diagram showing the 
background controller transition phases. 

A state transition in the background controller will occur only at the beginning of an opcode 
fetch cycle that Is coincident with other qualifying events. This is the earliest possible time 
after a break condition occurs, in which the jam state can occur. 

Refer to the background controller transition diagram (figure 2-2) for the following 
discussion. The background controller causes the emulation processor to enter the idle 
background state following the jamming operation. At this time, control of the address bus is 
returned to the emulation processor and the processor begins execution of a background 
entry program. During execution of the background routine, the processor registers are 
unloaded, return addresses are computed, and all other "housekeeping" tasks are completed 
to allow proper control for returning the emulation processor to foreground operation. 

When these operations are complete, the emulation processor will enter a TRAP loop and 
wait for instructions from the host processor. 

All host processor background memory accesses are totally transparent to the emulation 
processor. This makes it possible for the host processor to modify the jump address of the 
trap to coincide with the starting address of the background routine required to execute any 
host processor requests. 



EMULATOR/ANALYZER 6809/6809E 2-7 



BREAK 




Figure 2-2. Background Controller Transition Diagram 

The EXIT background state is entered when the host processor causes the emulation 
processor to make a jump to the EXIT routine in background memory. 

In the EXIT routine, the emulation processor is directed to the desired foreground entry point 
at which instruction execution would have continued if a break condition had not occurred. 

In the transition from the EXIT background state, the background controller enables the user 
interface buffers and allows processor execution of the foreground memory routine. 
Foreground memory can be user and/or emulation memory. Refer to the functional 
description of emulation memory for more understanding of foreground memory. 

Transitions through the background controller states of figure 2-2 occur whenever the host 
processor is used to control emulator operation or when any other break condition occurs. 
Single-stepping and continuous stepping of the emulation processor causes this type of 
transition through the background states. 
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Emulation Memory Functional Description 



Emulation memory for the 6809/6809E emulators consists of a memory control board and 
one or two memory boards. Each memory board can contain from 8K bytes to 32K bytes 
maximum of static RAM. Total emulation memory can be 64K bytes. This memory is for 
exclusive use by the emulator. 

The memory controller provides the ability to map the target processor's address space into 
1K byte blocks in the 64K byte address range. 

This mapping function allows available target and/or emulation memory to be placed 
anywhere in the address range of the target processor. The memory controller also provides 
status bits to identify each block of memory, whether it is mapped or not. This allows the 
emulator to determine whether a block of memory is RAM, ROM, or undefined. If an illegal 
memory operation is attempted, such as a write operation to ROM, the memory controller will 
send a break signal to the emulator indicating an error condition. 

The memory control board is the interface between emulation memory and the emulation 
control board. It is also the interface between the host processor and emulation memory. The 
host processor has no direct access to emulation memory. All memory accesses requested 
by the host processor go to the memory controller. The memory controller will grant a 
memory access to the host processor only if there is sufficient time between the emulation 
processor operations, or if the emulation processor is stopped. When the emulation 
processor is stopped, the memory controller will allow the host processor access to any 
memory location, including writes to memory mapped as ROM. 

A write operation to emulation memory mapped as ROM is accomplished with the "modify" 
or "load" command. 

The memory controller will not allow the emulation system to write to ROM since memory 
designated as ROM was defined in the context of the emulator. 

Host processor "writes" to emulation memory are nonreal-time for the 6809/6809E 
emulators. Host processor "reads" of emulation memory take place in real time. 
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Emulator Operating Modes 



The emulation system has two modes of operation: real-time, and nonreal-time. In addition, 
there are several options available through emulator configuration that affect these modes of 
operation. These options include the following: 

a. Detection of illegal opcodes 

b. Restricting emulation to real-time 

c. Memory mapping 

The real-time emulation mode allows the user to run real-time emulation with or without a 
target system connected to the emulator. In addition, emulation memory and user memory 
can be used individually or in combination for real-time emulation. When emulating, 
consideration should be given to the emulation configuration and also to the intent of the 
emulation session. 

Internal Emulation 



Internal emulation (no target system) is usually performed with the intent of debugging 
software. With internal emulation, the only clock that can be used is the internal clock of the 
emulator; therefore, code execution time will be relative to the internal clock speed. This 
should be kept in mind if the target system will have a different clock speed than the internal 
clock of the emulator. 

External Emulation 



The 64000 can perform emulation in real-time or nonreal-time with a target system. If the 
real-time performance of the target system is important, emulation should be done in real- 
time with particular attention to the type of run commands and analysis commands issued 
during emulation. 

In some cases emulation may be required to run in real-time because running in nonreal-time 
is not possible, such as with target systems that process interrupts and/or depend on a real- 
time clock for operation. Target systems of these types could not be emulated thoroughly if 
real-time emulation is not available. Therefore, it is important to be aware of the types of 
emulator commands that will cause the emulator to operate in nonreal-time. 
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In addition, the user should realize what implications arise when emulation memory is used 
in part or in whole for emulation. The use of emulation memory could affect real-time 
emulation depending on the implementation of the target system. Refer to the following 
paragraphs for use of emulation memory with respect to real-time emulation. 

Running The Emulator 

There are other considerations that should be taken into account for running the emulator. 
The ability to detect illegal opcodes can be selected and the ability to restrict running of the 
target processor to real-time can also be selected. These options are selected during 
configuration of the emulator. Refer to chapter 4 for information concerning these features. 

Emulation Memory and Target System Memory 

The use of emulation memory and/or target system memory can have some significance in 
the operation of the emulator. Ideally, emulation of a microprocessor should be done with as 
much of the final target system hardware as possible. Since this is not feasible at the 
beginning of the development cycle, the 64000 emulator provides emulation memory to 
replace target system memory during the project development stage. 

In general, the final target system memory will not have the same specifications as the 64000 
emulation memory. Therefore, selection of the clock for emulation can affect memory 
accesses by the target processor; so, the internal emulation clock would not be the clock to 
use with external hardware. This, in fact, is an illegal configuration for the emulation system. 
The emulator will, however, allow the user to specify use of the internal clock with a target 
system. When making a selection of a clock during configuration, there is the option to select 
an external clock to accomodate the target system. 

Emulation Configuration 

Emulation software provides the interface between the emulator and the host processor in 
the development station. When the "emulate" soft key is pressed, the emulation software for 
configuring the emulator is loaded into the development station memory from the system 
disc. At this point, the display will present a series of prompts or questions for configuring the 
emulator to the user specifications. The options for configuration of the emulator are covered 
in detail in chapter 4. 



EMULATOR/ANALYZER 6809/6809E 2-1 1 



When the emulator has been configured, the program that the user wishes to execute on the 
target processor should be loaded to the emulator as discussed in chapter 4. 

Using Symbols in Emuiator Commands 

Symbols may be used in any emulator command that allows expressions (as defined in 
chapter 7). A symbol is always interpreted as the address value of that symbol. Variables in a 
program can be conveniently accessed by name. Even though it is legal to use a symbol as a 
data value in a trace command, remember that the symbol will be interpreted as the address 
value, not the data value stored at the referenced address location. 

When using local symbols, the program module containing the symbol must be loaded by the 
emulator before the symbol can be used in a command. This is accomplished by using the 
"display" command or by specifying the program module with the symbol. 

When using local symbols in emulator commands, only valid symbols will succeed as 
specifications. A list of qualified local symbols can be viewed by using the "display 
loc_symb" command, or by displaying mnemonically the module containing the symbol. 

The ability to use symbolic referencing in emulation provides a very convenient tool for 
debugging code which has been assembled or compiled on the 64000 system. 

Analyzer Characteristics 

The 64000 system has an optional internal analysis board for analysis of emulation processor 
operation. The analysis capabilities are enhanced by the use of display or list commands, 
described in detail in chapter 6. 

The Trace Command 

The "trace" command can be specified with a wide range of complexity. In the simplest form, 
only "trace" need be specified. "Trace" also can be specified with a trigger, a qiralifier, a 
count, a break, or combinations of any or all of those terms. In addition, the trace may be 
performed repetitively, in which program execution continues while the trace memory and 
trace display are updated; or the trace, with its most recent specification, can be performed 
by "trace again". 

The trace command monitors program execution, and stores the program execution in 
chronological order in a 256 position trace memory. The trace memory can be displayed on 
the station CRT, or listed to a file or to the printer, for examination. 
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Analyzer Status 



Emulation analysis status can be specified with a numeric format from the keyboard, or 
through the soft key labels. 

When status is specified with the numeric format, the specification may be in either 
hexadecimal, octal, or binary base. When status is specified through soft keys, as many as 12 
labels are available. See chapter 3 for details on status specification. 

The Display Command 

An important feature of the 64000 emulators is the ability to display data for analysis in a 
format that is easy to interpret. This ability is implemented in the emulator by means of the 
"display" command. In addition to displaying trace measurement, the "display" command 
allows the contents of memory, internal registers, and program symbols to be displayed. The 
display commands are described in detail in chapter 6. 

The "display count" mode selects either an absolute time of execution (elapsed time after the 
trigger), or relative time of execution (elapsed time between each state). See chapter 7 for 
additional details about the "count" mode. 
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Chapter 

Operating Fundamentals 



Introduction 



This chapter contains general information pertaining to emulation and analysis of the 
6809/6809E microprocessors. The information provided refers to aspects of the processor's 
architecture and status specification. 

Processor Architecture 



The 6809 and 6809E series are memory-mapped I/O microprocessors with an 8-bit data bus 
and a 16-bit address bus. Each processor has ten internal registers consisting of the 
following: two 8-bit accumulators (A,B) which are concatenated by certain instructions to 
form a 16-bit accumulator (D); two 16-bit index registers (X,Y); one 8-bit condition register 
(CC); one 8-bit direct page register (DP); one 16-bit program counter register (PC), and two 
16-bit stack pointer registers (U,S). 

Some register names must include a prefix when access by the 64000 is attempted. Table 3-1 
lists the register names and their required access names. 
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Table 3-1. Register Access Names 



Register Name 



Access Name 



A 
B 

CC 

PC 

X 

Y 

U 

S 

DP 



A 
B 

CC 
PC 
IX 
lY 
USP 
SP 
DP 



Register D is not accessible as a single register, but is accessible through register A and 
register B. 

The 8-bit data bus is a bi-directional bus. A stack, which must be located in RAM, is used to 
handle subroutine return addresses automatically during subroutine call and return 
instructions. All of the CPU registers (except the stack pointers) are automatically pushed 
onto the stack at the beginning of the interrupt service. A wait for interrupt (CWAI) instruction 
provides quick interrupt servicing by placing all the CPU registers on the stack and then 
halting operation to wait for the interrupt. The 6809/6809E processors have on-chip Direct 
Memory Access (DMA) capabilities. External clock inputs are provided to allow 
synchronization with peripherals, systems, or other MRU's. 



Access to emulation memory may be convenient or necessary when an area that is mapped 
to emulation space contains vectors or other data useful to the emulation processor as well 
as other processors or DMA devices. Analysis of DMA activity allows direct measurements to 
be made of interaction between processor and DMA activities. 



If a user's interrupt occurs at the same time that the emulator is changing from foreground to 
background memory (e.g., step), the interrupt will be serviced on the next foreground entry. It 
is assumed that the user's system will keep the interrupt request asserted until the interrupt is 
serviced. If an NMI occurs while the emulator is in background memory, it will be serviced 
when the emulator next enters foreground. During single-step operation, the only evidence 
that an interrupt has occurred is the setting of the next PC register value to the vector of the 
interrupt. 



DMA Features 



Emulation Considerations 
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The 6809E emulator responds to the *TSC input like an actual processor. User access to 
emulation memory is not permitted in this mode due to timing considerations. 

When the 6809 emulator is in background memory, it will perform reads from OFFFFH. This is 
defined as a dummy cycle in the 6809 literature. Response to the *HALT and *TSC inputs is 
the same as in foreground memory (i.e., normal 6809 response). The *HALT line will always 
be serviced in less than 25 cycles. 

NOTE 



It is possible to inhibit emulator operation completely if the 
*HALT line is held low continuously. If the MRDY line (6809) 
or the *TSC line (6809E) is asserted continuously and is being 
sensed by the emulator, then emulator operation will be 
inhibited. Similarly, if *DMA/BREQ is asserted continuously, 
emulator operation will be slowed considerably. When power 
is not applied to the user's system, these lines are not sensed. 
When emulator operation is so inhibited, commands such as 
Restart_Processor, display user memory, etc. will not 
function. Before suspecting emulator failure in these cases, 
be certain that the *HALT, *DMA/BREQ, and MRDY or *TSC 
lines are not asserted. 



Emulator Status 



Emulator processor status can be specified to the emulator in two ways: numerically or by 
soft keys. Specification of status must be in a format which the emulation processor 
recognizes. The status specification is used in the trace command in the following form: 

status OXXH 

where "XX" represents the status byte. 

Numeric Status Specification 

An 8-bit byte is used to specify status numerically. The status byte may be specified in 
hexadecimal, octal, or binary. Refer to figure 3-1 for the status byte format. 
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The status bits given in figure 3-1 can be used to qualify trace specifications. For example, 
the specification: 

trace only status 0X0XXXXX1B 
will cause a trace of only those cycles that are both DMA and read transactions. 

Status Bits 



MSB LSB 



opcode 


dma 


aft_xfer 


ssr 


hsr 


fetch 


intr_vec 


read/write 



opcode = 0 for first cycle of an instruction 



dma = 0 for DMA cycles 

aft_xfer = 0 for cycles of an instruction that is a target 
of a branch 

ssr = 0 during execution of software interrupt service 

routine 

hsr = 0 during execution of hardware interrupt service 

routine 

fetch = 0 for prebytes (If any) and opcode fetch cycle, but 

not for operand or postbyte fetches 

intr_vec = 0 for vector fetches 

read/write = 0 for write cycles 
1 for read cycles 



Figure 3-1. Status Byte Format 

The hsr and ssr status bits become active during the first stack write executed in response to 
an interrupt. They are removed after the last stack read (the last return address fetch) of the 
service routine. Hardware inside the emulator counts subroutine calls and returns to 
determine when an interrupt service routine is completed. The maximum level of subroutine 
nesting allowed is 223. The hardware handling ssr and hsr are independent so they may be 
mixed freely in status specifications. 
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Instructions treated as subroutine calls for ssr and hsr status bits are: 

a. all JSR instructions. 

b. all BSR and LBSR instructions. 

c. all software and hardware interrupts. 

Instructions treated as subroutine returns for ssr and hsr status bits are: 

a. RTS, RTI. 

b. all pull instructions involving the program counter. 
Instructions treated as transfers of control for the xfer status are: 

a. all subroutine call instructions (see above). 

b. all subroutine return instructions (see above). 

c. all branch and long branch instructions conditional or unconditional. 

d. all transfer and exchange instructions involving the program counter. 

Soft Key Status Specification 

Trace specifications can be input using soft keys. That is, the appropriate bits are set for 
trace status qualification. An explanation of the trace status soft keys is given in table 3-2. 
The "Soft Key Label" column lists the name of the soft key, the "Binary Code" column lists 
the binary code making up the instruction, the "Command Line" column lists the command 
as it appears on the command line of the display when the soft key is pressed, and the 
"Remarks" column gives a brief explanation of the soft key function. 
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Table 3-2. Trace Status Soft Keys 



Soft Key 
Label 

read 

write 

opcode 

intr_vec 

not_int_v 

dma 

not_dma 
aft_xfer 

hsr 



ssr 



not_hsr 



not_ssr 



Binary 
Code 

0XXXXXXX1B 
OXXXXXXXOB 
OOXXXXXXXB 

OXXXXXXOXB 
0XXXXXX1XB 
OXOXXXXXXB 
0X1XXXXXXB 
OXXOXXXXXB 

OXXXXOXXXB 



OXXXOXXXXB 



0XXXX1XXXB 



0XXX1XXXXB 



Command 
Line 

read 

write 

opcode 



interrupt_vector 

not_interrupt_vector 

dma_transfer 

not_dma_transfer 

follows-transfer 



hdwr_int_serv 



soft_int_serv 



not_hdwr_serv 



not_soft_serv 



Remarks 

Read memory 

Write memory 

First cycle of an 
instruction 

Fetch 

Fetch 

DMA transaction 

not DMA transaction 

For cycles of an 
instruction that is the 
target of a branch. 

For all instruction 
cycles of a hardware 
interrupt service 
routine. 

For all instruction 
cycles of a software 
interrupt service 
routine. 

Excludes all cycles 
that are part of a 
hardware interrupt 
service routine. 

Excludes all cycles 
that are part of a 
software interrupt 
service routine. 
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Emulation Probe Pod Configuration 



The 6809 series emulator pod, shown in figure 3-2, is configured for a particular emulation 
session by using a combination of the plug-in leads extending from the front of the emulation 
pod, the switches located on the top cover of the emulation pod, and the configuration 
questions. 

The 6809E series emulator pod, shown In figure 3-3, is configured for a particular emulation 
session by using a combination of the plug-in leads extending from the front of the emulation 
pod and the configuration questions. 

In addition, If the emulator is to be used with a target system, the processor replacement 
probe must be installed In the target system as discussed in Chapter 1. 

Emulation Pod Plug-in Leads 

The emulation pods have nine external lines, separate from the emulation cable. These lines 
are labelled GROUND, *LUSER, *DMA, TUSER1, *FUSER2, *WR0M1, *WR0M2, *INT 
VEC1, and *INT \/EC2. The functions of these lines are given below. 




Figure 3-2. 6809 Series Emuiator Pod 
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Figure 3-3. 6809E Series Emulator Pod 



GROUND and *LUSER are outputs to the user system. GROUND is simply connected to 
emulator ground and should be used as an additional signal ground connection to the users 
system. *LUSER is generated by the emulator and indicates when the memory location 
addressed by the emulator (or DMA device) is in user or emulation memory. When *LUSER is 
low, the location being addressed by the processor (or DMA device) has been mapped to user 
memory. 

The 6809E emulator has the same capabilities with respect to HALT mode DMA as does the 
6809 emulator. Control and use of these capabilities are identical for both emulators. The 
TSC mode of DMA that is used with the 6809E, however, is supported only to the extent that 
the TSC signal functions on the emulator just as it does for a 6809E processor. DMA to 
emulation memory and internal analysis acquisition of TSC DMA cycles is not supported. 
TSC DMA cycles are completely transparent to the emulator (except for any clock 
stretching). 
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*DMA is an input to the emulator. It is used to inform the emulator that the current cycle is a 
DMA cycle. This causes the emulator to sense the address, data buses, and R/W line for 
emulation memory access and analysis. The *DMA line is sensed only when BA is high, 
signifying a halt initiated Bus Grant or Sync Instruction execution. The internal analysis 
circuitry, if present, will only be able to observe DMA activity if the *DMA line is low during a 
DMA cycle. If the DMA address is in emulation memory, it will respond to the request and 
perform a read or write, depending on the state of the R/W line. Reads from emulation 
memory will cause the data to appear on the data bus no later than 325ns after Q goes high. 
To guarantee a successful DMA write to emulation memory, the data bus must be stable at 
least 100ns after the rise of E. In all cases, the DMA address must be brought to the 6809 
address pins. The address must be stable no later than 52ns following the rise of Q. The R/W 
line must be stable no later than 13ns before the rise of Q. Typically, however, R/W may be 
allowed to stabilize as late as 30ns after the rise of Q. The *DMA line is provided to qualify 
potential DMA cycles. If this were not done (or if *DMA were tied to ground), all float cycles in 
a halt state and sync instructions would be labelled as DMA cycles. This would rapidly fill the 
internal analysis buffer with unusable data, and possibly alter emulation memory as well. 
Analysis of DMA cycles is only possible when internal analysis hardware is installed with the 
emulator. Memory cycles, when *TSC is asserted, are not analyzed and do not access 
emulation memory. 

The other six lines are similar in nature, but different in function. They are all similar in that 
they are used to force the emulator to access user memory under certain conditions. The 
differences lie in the circumstances under which user memory access is forced. The 
functions of these six lines are given below. 

NOTE 



The *FUSER, *WROM, and *INT VEC lines operate the same 
during DMA as during normal memory transactions. 



Since *FUSER1 and *FUSER2 are wire OR'ed in the emulator pod, either one will force the 
emulator to access user memory whenever either is brought low. The *FUSER lines may be 
used to access portions of user memory allocated within a block of emulation memory. 
Alternately, the user can use these two lines as a bank select; selecting user or emulation 
memory as two separate banks. 
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NOTE 



Under worst case conditions, the user has 43ns following the 
rise of Q to assert a *FUSER line and guarantee a user 
memory access. Typically, the user will have 63ns or more to 
assert *FUSER. For the *WROM and *INT VEC lines, the worst 
case time is 32ns following the rise of Q. The typical time is 
58ns. 

The emulator is designed for worst case values. Actual 
performance will vary from emulator to emulator. Typical 
performance is not guaranteed. 

Note that the emulator provides addresses 120ns following 
the fall of E. Consequently, for clock speeds less than 2 MHZ 
even more time, after the address is valid, is available to drive 
the user forcing lines. 



*WROM1 and *WR0M2 force the emulator to access user memory if one or both are brought 
low during a write cycle. Read cycles are not affected by these lines. The *WROM lines may 
be used to facilitate emulation in a system where program ROM addresses are shared with 
write only output ports. If it is desired that the ROM be in emulation memory, the *WROM 
lines should be connected to the chip select of the write only port. When the program writes 
to that port, emulation will be disabled and the write operation will be performed to the users 
system. If the emulation memory is declared as ROM, a break will not occur if either *WROM 
line is pulled low when the ROM address space is being written to because user memory is 
being accessed and not emulation memory. If the emulation memory is declared as RAM, the 
write will not destroy emulation memory contents because emulation memory is disabled for 
write operations while either *WROM line is low. 

*INT VEC1 and *INT VEC2 are functionally similar to the other user forcing lines except they 
are only sensed during interrupt vector fetch cycles. The *INT VEC lines are designed for use 
with the Motorola 6828 Priority Interrupt Controller which alters interrupt vector addresses in 
the user system. Since these altered addresses are stored in the 6828, and not in emulation 
memory, the users system must be accessed to read them. The *INT VEC lines function such 
that if one or both are pulled low during a vector fetch cycle, the vector will be fetched from 
the 6828 (or whatever vector generation logic exists in the user system) instead of from 
emulation memory. 
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Emulation Pod Switches 

There are three switches on the top of the 6809 series emulator pod: MRDY, INTERNAL 
CLOCK, and an unused switch. The switches function as follows: 



MRDY 



When the MRDY switch is in the "MRDY ALWAYS ENABLED" 
position, the emulator always responds to the MRDY line. When the 
switch is in the "MRDY ENABLED FOR USER MEMORY ONLY" 
position, the emulator will nto respond to the MRDY line when the 
emulator is in background memory or is accesssing emulator 
memory. 



INTERNAL CLOCK The INTERNAL CLOCK switch selects the emulator clock rate (1 
MHZ or 2 MHZ) when internal clock is selected. 

The middle position of the switches is unused and has no affect on the emulator. 

There are no switches located on the 6809E series emulator pod. 

Operating Clocit Specifications 

Proper operation of the 6809/6809E emulators requires that the operating clock speed is less 
than, or equal to, 2 MHZ. Since this is the maximum speed of the fastest available 6809/6809E 
processor, no questions regarding clock speed are presented during emulator configuration. 

Wait states will not be required when operating from user memory, provided that the user 
memory access time satisfies the following relationship: 

T <= T - T - T - T 

acc max eye Er max AD DSR 

For the 6809 emulator, these values are as follows: 



T 



4ns 



Er max 



T 



122ns 



AD 



T 



52ns 



DSR 
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T eye is determined by tlie operating eloek speed. Some eomputed values are as follows: 

T T 
eye aee max 

500 ns 296 ns 

667 ns 416 ns 

1000 ns 671 ns 
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Chapter 4 

Emulation and Configuration 



Introduction 



In order to become familiar with the emulation and analysis user interface and feature set, it 
is recommended that a short program be written and executed with the emulation probe 
disconnected from the target system or "out of circuit". A simple program that increments a 
single memory location or processor register will provide a good example. 



Assembly 



In general, source files are generated using the 64000 editor. The first line of a program 
specifies the processor name in quotes followed by options on the same line. The assembler 
or compiler will generate the proper object code for the processor specified. The code 
generated will be placed in a file of the same name as the source of type "reloc". Also a file of 
type "asmb_sym" is generated. This file contains all of the symbols local to the module and 
their addresses. The address of a symbol may be absolute, or relocatable and relative to the 
program, data, or common program counter. This file is used to determine the addresses of 
local symbols used in emulation commands. If this file is not present during emulation, local 
symbols for that module can not be referenced, displayed, or listed. 



Linking 



Relocatable files must be linked together to create an absolute file. To begin the creation of a 
new absolute file, enter [¥nk~j followed by \retum\ . This begins a sequence of questions which 



determine the files to be linked and their relocated addresses. The first question asks for 
object files. The name of the program to be run should be entered. Following the library files 
question the load addresses are requested. 
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Absolute File 



The last question to be answered when linking is for the name of the absolute file into which 
the relocated program is placed. The name given is also applied to a "link_com" file, and a 
"link_sym" file. 

The "link_com" file has in it the responses to the linker questions. The "link_sym" file 
contains the names and addresses of all global symbols in the modules that have been linked; 
and contains the names and initial addresses of the PROG, DATA, and COMM program 
counters. 

The program counter addresses are used to determine the addresses of all global symbols 
used in the emulation commands. 

Configuration 

To begin emulation with the example program, the command is issued in the form 
"measurement_system", for multimodule systems, or in the form "emulate", for single 
module systems. The syntax for each form is described later in this chapter. The command 
initiates a series of questions that configure the emulator for the particular application. Each 
question is provided with a default answer that can be entered as is with a [ return | or 
modified by using the soft keys or keyboard. The meaning of these questions and answers is 
described in detail later in this chapter. The questions and answers for interactive 
measurement are described in Chapter 7. For this example all of the default answers will be 
sufficient except during memory mapping. When the memory map is displayed, some portion 
of memory must be assigned. For this example the command "0 thru OFFFH emulation ram" 
is sufficient provided the program has been loaded in this area of memory. The mapping 
section of configuration is exited with the "end" command. The last question asked during 
configuration is "Command file name?". If a name is given, a file of type "emul_com" will be 
created. This file is similar in function to the link_com file and is described later in this 
chapter. For the example above a blank answer is sufficient but a file name may be entered. 

IVIeasurement System Command Syntax 

The measurement system can be entered through either one of two ways. If more than one 
module is present in the card cage, the command "meas_sys" will appear at the first level of 
soft keys. If an emulator is the only module present, the "emulator" will be present at the first 
level of soft keys. 
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For multiple module systems: 



measurement.system 



SYNTAX 



measurement_system [options continue] 



Default Value 

I 1 

I measurement_system is treated as a new entry into emulation I 

I I 
I I 

FUNCTION 

The command "measurement_system" causes system operation to enter the measurement 
system monitor. The measurement system monitor coordinates and displays the interaction 
between the modules present and, in multiple module systems, controls entry to and exit 
from the individual modules of the system. Once in the monitor program, the emulator can be 
entered by issuing the command "em6809_S" where "S" is the slot number of the emulation 
control board. The choice is made through the soft keys. 



The "continue" option allows reentry to a previous session without disrupting a measurement 
in progress. If "continue" is not specified, all measurmeent system modules will be reset to 
their default configuration and any activity stopped. A "continue" is not possible under any of 
the following conditions: 

a. Power has been cycled or the station reset by shift/reset. 

b. Performance Verification(option_test) has been initiated. 

c. The last session was exited by reset/reset. 

d. The measurement system configuration file is not present. 

e. A module was exited in a noncontinuable manner. 
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emulate 



SYNTAX 



em6809_S [<CMD_FILE>] 



where "S" is the slot number of the emulator control board, and "<CMD_FILE>" is an 
optional emulation command file. 

Default Value 

I 1 

I <CMD_FILE> The last specified command file. ( 

I I 

FUNCTION 



The emulate command, when issued from the measurement system monitor program, 
transfers action to the monitor program for the specified emulator. If no command file exists, 
or there is a conflict between the specified command file and the previous configuration, the 
emulation configuration questions are initiated and either a new command file is generated, 
or the specified file is edited. 
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For single module systems: 



emulate 



SYNTAX 




Examples: 

emulate 

emulate LOOP 

emulate LOOP load MUCH 

FUNCTION 



The emulate command, when issued from the measurement system monitor program, 
transfers action to the monitor program for the specified emulator. If no command file exists, 
or there is a conflict between the specified command file and the previous configuration, the 
emulation configuration questions are initiated and either a new command file is generated, 
or the specified file is edited. 
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Execution 



After configuration the execution portion of emulation is entered. In this case the processor 
has been reset. This condition is reported on the Status line of the display. At this point the 
absolute file must be loaded into emulation memory using the load command in the form 
"load <ABSFILE>". 



Running The Program 



Once the example program has been loaded, the run command can be issued to begin 
execution of the program. If the command "run" is given, program execution will begin at the 
transfer address specified in the source program. This is either the label given with the END 
pseudo-op at the end of an assembly language module, or the main routine of a PASCAL 
program. Thereafter "run" will cause execution to begin at the next program counter address 
as specified in the register display. If "run from <ADDRESS>" is issued, execution begins at 
the address specified. 



Configuration Questions 



The emulation configuration questions are used to prepare the emulation hardware and 
software for a specific application. Each question is displayed along with a default response, 
with additional options here shown in parentheses. Selecting the default responses will set 
up the emulation configuration that is easiest to use in most applications. The default 



response can be selected by pressing the return key; or another response can be selected by 



the appropriate soft key, ro by typing in a suitable response. 



Once the questions have been answered for the particular application, the answers can be 
stored in a command file on disc so that the question and answer sequence need not be 
repeated for each emulation session. If changes to an emulation command file are desired, 
the file can be edited using the [mod ityj jco nfig"} soft keys. This allows changing only specified 
answers. At the end of the modify configuration sequence, a new file name can be assigned 
to the edited configuration, or the old file can be over written with the new information. 

Throughout this discussion, the available soft key entries for each question are listed 
following the question. If an emulation command file is being edited to reconfigure the 
emulator, the default responses provided are the responses that were entered when the 
command file was originated or last edited. 
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The questions are divided into the eight sections listed below. 

a. Card Selection 

b. Clock Selection 

c. Real Time Selection 

d. illegal Opcode Detection 

e. Memory Configuration 

f. Simulated I/O Configuration 

g. Interactive Measurement Configuration 

h. Command File Designation 

These sections are discussed on the following pages. The questions discussed in the first 
section are only presented when more than one emulation control board and/or more than 
one memory control board is installed in the 64000. 

Card Selection 

It may be necessary, in multiple module systems, to specify the slots of the memory 
controller and internal analysis cards associated with the emulator being used. The following 
questions will appear: 

Slot number of memory controller card? 0 . . 9 (none) 

The default answer will be the slot number of one of the memory controllers, or the slot 
number specified in a command file. It is possible for emulation to take place without a 
memory controller, provided that all memory is user memory. The ability to detect 
illegal memory references while the processor is executing the target program cannot 
be provided without the memory controller installed. 

Slot number of analysis card? 0 . . 9 (none) 

The default answer will be the slot number of one of the analysis cards, or the slot 
number specified in a command file. It is possible to emulate without the benefit of an 
analysis card by selecting "none". None of the functions, however, that require an 
analysis card will be usable. The functions requiring an analysis card are run until, and 
trace. 

Clock Selection 

Microprocessor clock source? internal (external) 

internal Selects a 2 MHZ or 1 MHz clock source in the probe pod; this 

source should be selected when operating without a target system. 

external Selects the clock source in the user system. 
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Real Time Selection 

The question listed below provides an opportunity to restrict the emulator to real-time 
program execution. "Real time" in this case is not based on whether wait states are inserted 
or not, since none are needed by the emulator. Instead, real-time refers to the continuous 
execution of the user's program without interference from the development system except as 
instructed by the operator. 

Interference can come from two sources: 1) stopping the processor (and DMA activity) so 
that the host processor can access emulation memory, 2) automatically breaking into the 
background memory. Host processor access to emulation memory usually stops the 
emulation processor for 34 to 40 microseconds. The display/modify emulation memory 
features access emulation memory and pause the emulator once for every location that is 
specified. Features that utilize the background memory are display/modify registers and 
display/modify memory. 

Breaking into the emulation background memory may happen if a feature that requires the 
background memory is invoked while the processor is executing user programs. After the 
feature is completed the processor is returned to the user program. 

Restrict to real-time runs? no (yes) 

no If runs are not restricted to real time, all keyboard commands will be accepted. 

The host processor will generate a break into the background memory if a feature is 
invoked which requires the background memory and the processor is executing a user 
program. 

yes If operation is restricted to real time runs, emulator features like display/modify 
memory, display/modify registers, and load, which require the host processor to 
access emulation memory or utilize the background memory, must be explicitly 
enabled by a hardware break. Hardware breaks can be generated by an analysis 
("trace break_on...") command, by the emulation memory controller (access to illegal 
memory or write to ROM), or from the keyboard by entering "break". These features 
are disabled by the "run" command, and no automatic breaks into the background 
memory will be performed. The user's system will not experience any pauses or other 
interference once the "run" command has been entered. 
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Illegal Opcode Detection 



Break processor on illegal opcodes? yes (no) 

This option helps find unexpected executions in absolute code. If yes is selected, the 
processor will stop emulation if an invalid opcode is fetched. If no is selected, the emulation 
processor will attempt to execute the opcode in the same manner as the microprocessor unit 
being emulated. 

Memory Configuration 

In order to perform emulation, the memory mapper must be properly programmed to 
correspond to the desired emulation and user system memory resources. The memory 
mapper allows the user to divide the processor's address space into a number of blocks that 
can be individually assigned any one of five descriptors: emulation RAM, emulation ROM, 
user RAM, user ROM, or guarded memory. During emulation, the mapper monitors the 
address bus and provides the descriptor for the address present at any given time. This 
information is used by the emulator hardware to control the flow of data between the 
emulation processor and the memory resources. 

The responses to the memory configuration questions are used to configure the memory 
mapper. These questions are explained on the following pages. 

Modify memory configuration? no (yes) 

Memory Map 

The memory map describes the partitioning of the processor address range into emulation 
RAM/ROM, user RAM/ROM, or illegal space for the emulation system. 

The map is composed of from 0 to 32 entries plus memory default. Each entry must be an 
integral multiple of the IK byte (1024 bytes) block size. The remaining parts of the address 
range, not covered by an entry, are mapped to the memory default. 

At the top of the map display is information describing the amount of emulation memory 
available to be mapped, the amount already mapped, and the memory block size. The 
remainder of the screen above the status line shows up to 32 entries arranged in two 
columns. Each entry is displayed as an entry number the address range covered, the memory 
type, and then (if the type was emulation memory) the physical block number actually used. 
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Entries are made by typing in an address for a single blocl< or an address range followed by 
either: 



(a) user 



rom 



ram ) 



(b) emulation 



rom \ 



ram 



[overlay <ADDRESS>] 



(c) guarded 



where: 



rom - designates memory which can detect the occurrence of write cycles and, if it is 
also emulation, memory which cannot be modified by the emulation processor, but 
only by the host via the modify memory and load commands. 

ram - designates memory which can be read or written without restriction. 

user- designates memory to be found in the user system. If the emulator is operating 
without a user system, then latches in the pod can be accessed which record the last 
write cycle address. 



emulation - designates memory to be supplied by the emulation system. 



guarded - designates an address space which is not expected to be accessed. A 
memory cycle to this space will always attempt to break the processor. 



As indicated above, emulation memory may be overlaid for purposes of memory 
management. Physical memory locations may be given more than one logical address. For 
example, the following entries are made during memory configuration: 



2000H thru 3FFFH emulation ram 



OEOOOH thru OFFFFH emulation rom overlay 2000H 
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The screen will show: 



Entry Range Type Blocks 

1 2000H - 3FFFH RAM/EMUL 000 - 001 

2 EOOOH - FFFFH ROM/EMUL 000 - 001 

The effect is that emulation memory blocks 000 and 001 can be accessed either from 2000H 
thru 3FFFH or from OEOOOH. Locations 2000H and OEOOOH refer to the same physical 
location. The designation of ROM or RAM is not significant other than to show the flexibility 
of this technique. 

Table entries may be removed by entering: 



delete 



The memory default is usually guarded, but it may be changed by entering: 




user 



rom 



ram; 



default 



guarded 



A hard copy of the memory map cna be obtained at any time during the mapping session by 
pressing the jprinTj soft key. If no printer is connected to the system, an error message will be 
displayed. 

Ending the Mapping Session 

The memory map configuration session is exited by pressing the ["end"] soft key followed by 
If an attempt is made to end the mapping session with a blank memory map, an 



RETURN 



error message will be displayed. 
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Simulated I/O Configuration 

Simulated I/O configuration begins upon completion of memory configuration. Available 
host memory for simulated I/O is determined by the number of measurement system 
modules present. If the maximum number of measurement system modules (4) is present, 
then simulated I/O memory is not available and the simulated I/O configuration is not 
presented. If three or less modules are present, then the host memory available is as follows: 

one measurement system module, available memory is 768 words. 

two measurement system modules, available memory is 512 words. 

three measurement system modules, available memory is 256 words. 

Available memory is allocated during the actual emulation when an open command is 
requested for simulated I/O devices. Some devices do not require additional memory. The 
simulated I/O devices that require memory are: display, printer, RS232, and disc files. 

Each device, except RS232, requires a minimum of 145 words of memory space. RS232 
requires 128 words of memory space for the read buffer, and 128 words of memory space for 
the write buffer. 

A maximum of five devices, not including RS232, may be open at one time for a single module 
measurement system or 768 words available. With RS232 read and write buffer operation, 
another three devices may be opened. 

A maximum of three devices, not including RS232, may be open at one time for a dual module 
measurement system or 512 words available. With RS232 read and write buffer operations, 
only one other device may be opened. 

A maximum of one device, not including RS232, may be open at one time for a triple module 
measurement system or 256 words available. With RS232 operation, only one read buffer and 
one write buffer may be open, but no other devices may be opened. 

Available memory is deallocated during actual emulation when a close command is 
requested for the simulated I/O device. Deallocated memory can then be allocated to some 
other simulated I/O device. 

If simulated I/O devices try to allocate more memory than is available, an error return of 9 
(request not allowed) is returned to the simulated I/O device control address. 
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When there is available memory for simulated I/O, the command line displays the following 
question and answer: 

Modify simulated I/O? no (yes) 

The status line shows: 

STATUS: Simulated I/O assignment 

Answering yes to "modify simulated I/O?" will allow modification to all available simulated 
I/O devices. The simulated I/O devices are: display, printer, RS232, keyboard, and up to six 
disc files. 

Questions for a control address for each device are then asked. If a reply of blank is made, 
then that device is not used. The control address may be specified for a maximum width of 32 
bits. The 16 most significant bits, however, must be entered as zeros. 

As each question is answered the results are displayed. 

The simulated I/O questions are: 

a. display control address? 

b. printer control address? 

c. RS232 control address? 

d. keyboard control address? 

Each unit is identified with a physical address. 

Next the command line displays: 

modify simulated disc files? no (yes) 

Answering no bypasses any modification to simulated disc files I/O. Answering yes allows 
modification to simulated disc files. 

The disc file simulated I/O questions are: 

file 1 name? 

file 1 control address? 

file 2 name? 

file 2 control address? 
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file 3 name? 

file 3 control address? 

file 4 name? 

file 4 control address? 

file 5 name? 

file 5 control address? 

file 6 name? 

file 6 control address? 

A blank file name disables simulated I/O for the specified file number. Refer to Chapter 8 for 
further details on simulated I/O. 

Interactive Measurement Configuration 

It is possible to coordinate measurements between the modules of a multiple module system 
by selecting various options possible under this catagory. Since all of these options pertain 
to the capabilities of the internal analysis card, and are used in conjunction with the trace 
command, a detailed explanation of these options is included in Chapter 7, along with the 
other information about internal analysis. Options selected for interaction will be displayed 
by the measurement system monitor in mulitple module systems. 

The following question is presented, allowing the user to modify or leave the current 
interactions unchanged. 

Modify interactive measurement specification? no (yes) 

Allows modification of the internal analysis external inputs and outputs. 

If the interactive measurement specification is modified, any function or measurement 
involving the analysis card will be discontinued. The remainder of, the system, however, will 
not be affected. Any conflict between the interaction specified by a command file and the 
interaction specified by the measurement system monitor that cannot be resolved, will 
require modification of the interactive measurement specification for resolution of the 
conflict. 

Command Fiie Designation 

Command file name? <FILE_NAME> 

This question allows the user to establish a command file containing all of the 
information pertaining to the questions just answered for emulation configuration. The 
command file is stored on disc and can then be called up for use during any future 
emulation session. 
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All that is required to create the command file is to type in a file name. If no file name is 
entered, the configuration information will not be stored, and the questions will be 
required to be answered for each emulation session. 

Configuration questions and answers will be stored in a command file of the name specified. 
Default is the current command file. If no command file exists, a new file will be created under 
the name provided. Specifying a command file avoids having to answer the configuration 
questions each time an emulation session is begun. There must be a command file specified 
for each module in a multimodule emulation session. 

Emulation can be started with the same configuration by specifying the emul_com file name 
along with the "emulate" command. The answers to the questions may be changed by 
specifying "options" "edit" with the "emulate" command. When emulation is ended using the 
'end' command, the current state of the processor is stored in the emul_com file. An 
additional file of type "trace" is created containing the current analysis specification. This 
information allows emulation to be re-entered without reseting the processor and analysis 
hardware. This is done by specifying "options" "continue" in addition to the emul_com file 
name with the "emulate" command. When entering an emulation session through 
"measurement_system" and "em6809_S", an emulation command file is the only available 
option. An emulation session within measurement_system will always be continued, if 
possible. Editing of an emul_com file will be allowed only if there is a conflict, between the 
configuration file and the hardware, that must be resolved before entering the emulation 
session. 
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Chapter 



Operational Commands and System 

Command Files 



Introduction 



Operational commands and system command files are described in this chapter, display/list 
commands are described in Chapter 6, and analysis commands are described in Chapter 7. 

Command Line Comment Delimiter 



The comment delimiter is a semicolon, and is interpreted in such a way that any text 
following the semicolon, to the end of the command line, will be ignored by the emulation 
system. 

In the example: 

run from START; causes program execution to begin 
only the command line text, "run from START", will be acted upon. 

Operational Command Syntax 

The syntax listings on the following pages are intended to acquaint the user with the different 
operational commands. The syntactical variables used in this discussion are described 
in detail in Appendix A. 
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break 



SYNTAX 




Default Value 



Example: 

break 
FUNCTION 

Break causes the processor to be diverted from execution of the user program to background 
memory. See Chapter 2 for details of the break function. 
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end 



SYNTAX 



end 



Default Value 

I 1 

I I 



none 



I I 

Example: 
end 
FUNCTION 

The end command terminates the current emulation session and returns the 64000 operating 
system to the station monitor mode. The current states of the processor and trace are 
recorded in the emulation command file and a trace file of the same name. Emulation can 
then be resumed using the "emulate <CMDFILE> options continue" command. If emulation 



is terminated using the | reset \ key, emulation cannot be resumed, and the emulation 
command file is not overwritten. In a multiple_module system, the "end" command returns 
control to the measurement- system monitor program. 
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execute 



SYNTAX 



execute [repetitively] 



Examples: 

execute 

execute repetitively 
FUNCTION 

Execute causes a measurement to begin. The [execute^ soft key label will be replaced witli the 
[jiairjsoft l<ey label whenever a measurement is in progress. If emulation is participating in a 
system measurement, through cross-triggered analysis or the emulation start function 
(specify run), then the global measurement is initiated. Otherwise, a local measurement is 
begun and execute functions identically to "trace again", i.e., it executes a trace using the 
previous specification. A measurement can be executed repeatedly by issuing the execute 
repetitively command. This will restart the current measurement after each completion, until 
the user issues a halt command. 

A key feature of the execute command is that it will start all the modules participating in a 
system measurement when issued from any one of the modules. If an emulator is started as 
part of a measurement it will continue running and will not be started again by subsequent 
executions unless a specify run command is again issued. The {"execute] soft key is displayed 
only with multiple module systems. 
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halt 



SYNTAX 



halt 



Example: 
halt 
FUNCTION 

Halt causes the measurement currently executing to stop and turns off the repetitive option. 
The [hair} soft key is only displayed during execution in the place of the [execute] soft key. 
When the halt command is performed, some or all of the modules involved may have 
completed their measurement. Halt affects measurement caused by both trace and execute 
commands. If emulation is entered with a measurement in progress, halt will stop that 
measurement even if emulation is not interacting in the measurement. The [hairjsoft key is 
displayed only for multiple module systems. 
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load 



SYNTAX 











~user_ memory ~ 




load 


emulation_memory 


<FILE> 




trace 











Default Value 

r 




Examples: 



load KW3000 

load emulation_memory KW3000 
load trace K5 



FUNCTION 



The load command transfers absolute code from the 64000 system disc into user RAM or 
emulation memory. The destination of the absolute code is determined by the memory 
configuration map which was set up during emulation configuration and the address 
specified during linking. Load trace allows the display command to access and display a 
previously stored trace. Load trace also allows execution of the trace specification via the 
trace again or execute commands. 



Parameter 

<FILE> <FILE> is the identifier of the absolute file to be loaded from the 

64000 system memory into user RAM or emulation memory or the 
trace file containing a previously stored trace specification. The 
syntax requirements for <FILE> are discussed in Appendix A. 
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modify 



SYNTAX 



modify 




<ADDRESS>[thru<ADDRESS>]to<REAL_VAL>,[<REAL_VAL..>] 



memory < 



byte 



^^wordj 



<ADDRESS> [thru<ADDRESS>] to<VALUE> [,VALUE...>] 
.register <REG_NAME> to <VALUE> [,<REG_NAME> to <VALUE...>] 



Default Value 

I memory real [short]: if display real is in effect, default is to mode of display, otherwise | 
I [long] default is to the last mode specified, or to short. i 



memory [byte]: 
[word] 



L_ 



if memory display is in effect, default is to mode of display. 
Otherwise, default will be the last value specified, or to byte. If word 
is specified, addresses specified will be truncated to word 
addresses. 



Examples: 



modify configuration 

modify memory word OOAOH to 1234H 
modify memory byte DATA1 to 0E3H,01H,08H 
modify memory DATA1 thru DATA100 to OFFFFH 
modify memory byte ARRAY thru ARRAY+16 to 0,OFFH 
modify memory real 0675H to -1.303 
modify memory real long TEMP to 0.5532E-8 
modify memory real short FIRSTREAL thru LASTREAL to 
1 .1 1 E1 ,2.22E-3,-4.56,9.99E1 7 

modify register A to 39H 

modify register B to OAH, PC to 18H 

modify register SP to 13A0H 
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modify 

(Cont'd) 



FUNCTION 

The modify command is used to review or edit the configuration, to modify the contents of 
memory (as integers or as real numbers), to modify the contents of the processor registers. 
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modify configuration 



SYNTAX 



modify {configuration} 



Default Value 

I 1 

I I 

I none | 

I I 
I I 

Example: 

modify configuration 
FUNCTION 

The modify configuration command allows the current command file to be reviewed and 
edited. Each of the configuration questions is presented with the response previously 



entered. The prior response can be entered as displayed by pressing \return\ , or modified 
as necessary and then entered by pressing 



RETURN 



The command is invoked through the j^odify] [ronfigj soft keys. 
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modify memory 



SYNTAX 



real 



short 
Jong J) 



<ADDRESS> thru<ADDRESS>] to<REAL_VAL>[,<REAL_VAL>...] 



memory < 



byte 




_word_ 





:ADDRESS>[thru<ADDRESS>]to<VALUE>[VALUE>..] 



i 



Default Values 

I 1 

I For integer memory modifications, initially default is to the display memory mode if in effect, I 

otherwise default is to byte; thereafter default is to the display memory mode, or else to the 

I last modify mode. | 

I For real memory modifications, default is to the display memory mode if in effect, otherwise I 

to short; thereafter default is to the display memory real mode if in effect, or to the last mode. I 



L 



J 



Examples: 



modify memory word OOAOH to 1234H 

modify memory byte DATA1 to 0E3H,01H,08H 

modify memory DATA1 thru DATA100 to OFFFFH 

modify memory byte ARRAY thru ARRAY+16 to 0,OFFH 

modify memory real 0675H to -1.303 

modify memory real long TEMP to 0.5532E-8 

modify memory real short FIRSTREAL thru LASTREAL to 

1.11 El, 2.22E-3, -4.56, 9.99E17 



FUNCTION 



The modify memory command can modify the contents of each memory location in a series 
to an individual value or the contents of all of the locations in a memory block to a single or 
repeated sequence of values. 
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(Cont'd) 



memory 



Parameters 



<ADDRESS> 



<ADDRESS> determines which memory location or series of 
locations are to be modified. 



<VALUE> 



<VALUE> is the number which is to be loaded into the specified 
memory location or locations. The syntax for <VALUE> is 
described in Appendix A. 



<REAL_VAL> 



<REAI VAL> is the real number value to be loaded into the 

specified memory location or locations. The syntax for 
<REAI VAL> is described in Appendix A. 



DESCRIPTION 

A series of memory locations is modified by specifying the address of the first location in the 
series to be modified (<ADDRESS>) and the list of the<VALUE>s, including <REAL_VAL>s, 
to which the contents of that location and the succeeding locations are to be changed. Both 
bytes must be addressed if a memory word is to be modified. The first <VALUE> listed 
replaces the contents of the specified memory location, the second <\/ALUE> replaces the 
contents of the next location in the series, and so on until the list has been exhausted. If only 
one number or symbol is specified, only the single address indicated is modified. When more 
than one <VALUE> is listed, the <VALUE> representations must be separated by commas. 

An entire block of memory can be modified such that the contents of each location in the 
block is changed to the single specified <VALUE>, or to a single or repeated sequence. This 
type of memory modification is achieved by entering the limits of the memory block to be 
modified (<ADDRESS> thru <ADDRESS>) and the <VALUE> or list of values, 
<VAHJE> <\/ALUE>, to which the contents of all locations in the block are to be changed. 
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modify register 



SYNTAX 



modify {register <REG_NAI\/IE> to <VALUE>[<REG_NAME> to <VALUE>...]} 



Default Value 

I 1 

I none ^ 

I I 
1 I 

Examples: 

modify register A to 39H 

modify register B to OAH, PC to 18H 

modify register SP to 13A0H 

FUNCTION 

The modify register command is used to modify the contents of one or more of the 
microprocessor's internal registers. The entry for <REG_NAME> determines which register 
is modified. 

Register modification cannot be performed during real time running of the processor. A 
break must be performed to gain access to the processor registers. 

Parameters 

<VALUE> <VALUE> is the number which is to be loaded into the specified 

processor register. The syntax for <VALUE> is described in 
Appendix A. 

<REG_NAME> <REG_NAME> represents the name of one of the registers to be 

modified. The possible entries for <REG_NAME> are shown in the 
heading on the register display. 
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reset 



SYNTAX 



reset 



Default Value 

1 1 



none 

I I 
I I 

Example: 

reset 
FUNCTION 

Reset suspends target system operation and reestablishes initial operating parameters, such 
as reloading control registers. 
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run 



SYNTAX 



run [from <ADDRESS>] [until <UNTIL_TRIGGER>] 



Default Value 



r 



<ADDRESS> 



<ADDRESS> option may be an address or a label. If the 
<ADDRESS> option is omitted, the emulator will begin program 
execution at the current address specified by the processor's 
program counter, or, if an absolute file containing a transfer 
address has just been loaded, execution will start at that address. 



J 



Where <UNTIL_TRIGGER> is defined as: 



<STATE> [occurs <#times>] [or <STATE>] 
<RANGE_STATE> [occurs <# times>] 



See the trace command syntax for definitions of <STATE> and<RANGE_STATE>. 



Examples: 



run 

run from 1000H 

run from COLD_START 

run until OAFFH 

run until 1FFH thru 20FH occurs 3 times 
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run 

(Cont'd) 



FUNCTION 

If the processor is in a reset or break state, run will cause the processor to begin executing 
from the next PC, and if a "from" address is specified the processor wili be directed to that 
address. The program can either be run from specified <ADDRESS> or from the address 
currently stored in the processor's program counter, or from a label specified in the program. 

Parameters 

from <ADDRESS> from <ADDRESS> represents a state on the address bus which can 
be used to start a program run. The syntax requirements for 
<ADDRESS> are equivalent to those for <VALUE> as defined in 
Appendix A. 

until <UNTIL_TRIGGER> uses internal analysis to cause an exit from a user 

program to background memory when a state 
satisfying the <UNTIL_TRIGGER> term is en- 
countered. 
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specify 

SYNTAX 



specify 



run [from <ADDRESS>] 
<TRACE_COMMAND> 



Examples: 



specify run from START 
specify trace after address 1234H 



FUNCTION 



Specify is used to prepare a run or trace command for execution, and is used in conjuntion 
witli the execute command. If tlie processor is not reset, then specify run causes a break from 
a user program, and initializes the PC to the default address or to the specified address. An 
execute command will then cause the run to occur. Once an execution has occured, the run 
specification is removed and can not be repeated without respecifying the run. 

If the processor is reset and no address is specified, then an execute will cause the processor 
to run from the next condition. If the processor is reset from specified address, then the 
processor is allowed to run and the next program count is set up for the specified address. 

Specify trace causes the trace hardware to be initialized with the given trace specification. An 
execute command will then cause the trace to be executed. A trace specification is not 
removed and can be reexecuted without another specify trace command. Specify trace and 
specify run can be used with a single execute command initiating both the run and the trace, 
but this mode can only be used if the internal analysis is configured to participate in a system 
measurement. If internal analysis is not configured, then specify trace and specify run are 
mutually exclusive and issuing one after the other will negate the first command. If specify 
trace is followed by execute, the effect is identical to trace. If specify run is followed by 
execute, the effect is the same as run, except that if a system measurement is configured, it is 
initiated. The [^wity^ soft key label is displayed only with multiple module systems. 
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step 



SYNTAX 



step [<# STEPS>][from <ADDRESS>] 



Default Values 



r 



<# STEPS> 



If no value is entered for number of times, only one instruction is 
executed each time the RETURN key is pressed. Multiple 
instructions can also be executed by holding down the RETURN 
key. 




from <ADDRESS> If the from <ADDRESS> option is omitted, stepping begins at the 



step 

step from 1000H 
step 20 from 2000H 

FUNCTION 

The step command allows program instructions to be sequentially analyzed by causing the 
emulation processor to execute a specified number of instructions. The contents of the 
processor registers and the contents of emulation or user memory can be displayed after 
each step command has been completed. 

Parameters 

<# STEPS> <# STEPS> determines how many instuctions will be executed by 



from <ADDRESS> from <ADDRESS> represents a state on the address bus which can 



next program counter address. 




_l 



Examples: 



the step command. The number of instructions to be executed can 
be entered in binary(B), decimal(D), octal(0, or Q), or hexadecimal 
(H) notation. 



be used to start a program run. The syntax requirements for 
<ADDRESS> are equivalent to those for <VALUE> as defined in 
Appendix A. 
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stop -trace 



SYNTAX 



stop-trace 



Default Value 

I I 



none 



I I 

Example: 

stop_trace 
FUNCTION 

The stop-trace command terminates the current trace, and stops the execution of the 
current measurement. That is, the system stops searching for trigger and trace states. Trace 
memory, although incomplete, can be displayed. Stop_trace will also halt internal analysis if 
it is being used in "run until" mode. 

The command is invoked through the [»top_trc] soft key. 
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store 



SYNTAX 



store 



memory <ADDRESS> thru <ADDRESS> 
trace 



to <FILE> 



Default Value 



r 



none 



J 



Examples: 



store 800H thru 20FFH to TEMP2 
store EXEC thru DONE to TEMP3 
store trace to TRACE 

FUNCTION 

The store command is used to store the contents of specific memory locations in an absolute 
file or the trace memory in a trace file. 

Parameters 

<ADDRESS> <ADDRESS> determines the memory locations from which data is 



<FILE> determines the name under which the absolute or trace file is to be stored. The store 
command creates a new file having the specified name as long as there is no absolute file 
presently on the disc with that name. In the cases where a file represented by the <FILE> 
variable already exists, the system asks whether the old file is to be deleted. If the response is 
yes, the new file replaces the old one. If the response is no, then the store command is 
cancelled and no data is stored. Transfer address of absolute file is set to zero. 



to be stored into the specified absolute file. 



<FILE> 



<FILE> is the identifier for the absolute file or trace file in which 
data is to be stored. The syntax requirements for <FILE> are 
described in Appendix A. 



DESCRIPTION 
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System Command Files 



System command files can be used within an emulation session, but must be constructed 
before the emulation session begins. A soft key prompt allows insertion of the system 
command file into program execution. 

A system command file can be constructed by using the following procedure: 

a. From the system monitor level, issue the command "log_commands to NEW". 

b. Enter emulation session. 

c. Proceed thru all desired commands. 

d. End emulation, return to the system monitor level and "log_commands off". 

e. Edit NEW (the command file just created) by deleting the undesired commands or 
mal<ing any changes needed. 

f. The system command file is now ready for use within the emulation session. 
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<CMDFILE> 

SYNTAX 



<CMDFILE> [FARMS] 



FUNCTION 

<CMDFILE> is the system command file name and is further described in Appendix A. The 
use of [FARMS] is described in the system manual under command files. 
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Command Delays 



wait 



SYNTAX 



wait 



<NUMBER> 



measurement_complete 



Default Value 

I 



L 



Examples: 

wait 
wait 6 



any l<eystrol<e 



n 

I 

J 



will wait for any keystroke before accepting the next command. 

will wait for any keystroke or 6 seconds before accepting the next 
command. 



wait measurement-complete 



will wait for any keystroke or for a pending 
measurement to become complete. If no 
measurement is in progress, wait will be 
satisfied immediately. 
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wait 

(Cont'd) 



FUNCTION 

Command delays are enhancements that allow flexible use of system command files. 
Parameters 

<NUMBER> is a number of seconds (65,535 maximum) before the next command 

is executed. 

measurement-Complete is a delay until a measurement has been completed 

before the next command is executed. 

When operating in REMOTE mode, wait for keystroke only is not allowed. A <NUMBER> or 
measurement-Complete term must be included with the wait command. Pressing the system 
RESET I key will satisfy the wait for keystroke condition and will stop execution of a 
command file, if a command file is currently being executed. 

DESCRIPTION 

The usefulness of command delays lies in the capability to give the emulation system and 
target processor time to reach some condition or state before bringing in the next command. 
The delay commands may be included in the system command file. 

The following example shows the use of wait commands within a system command file. 

load PROGRAM 

run from SUB1 

trace about BEGINNING 

wait measurement-Complete 

trace only address range DATASTART thru DATAEND 

run from SUB2 

wait 8 

stop-trace 

list FILE1 trace 

run from SUB3 

Run from subroutine 1 and accept the next command after measurement is completed. Trace 
in DATA area while running subroutine 2, then list to a file after subroutine 2 has been 
completed. Wait 8 allows the processor 8 seconds before the stop_trace becomes effective. 
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Chapter 

Display and List Commands 



Display and List Command Capabilities 

There are four basic types of information which may be viewed by using either the display or 
list command. These are: 

Memory data 

Register contents 

Trace information 

Global and local symbols 

Memory Data 

For data taken from memory, the starting address in memory or a list of memory address 
ranges may be specified. 

Whether the data comes from emulation or user memory depends upon the memory map 
assignments made during configuration of the emulation command file. Unless otherwise 
specified, memory data is displayed statically with the actual memory address shown. (The 
static display shows the memory contents existing when the display command is executed.) 
The data is displayed in hexadecimal form with corresponding ASCII characters as shown in 
figure 6-1. 
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Figure 6-1. Memory Contents - Hexadecimal and ASCII 



Syntax for the display and list commands is very similar. The repetitive option, however, is 
available for display commands only. The display and list commands can be modified so that 
memory data is displayed or listed using one or more of the following techniques: 

a. Data may be viewed in a repetitive mode which causes the display to be constantly 
updated. This can be useful if the data in the memory is continuously changing. The 
display, however, is not updated in real time. 

b. Data may be viewed in mnemonic form rather than in hexadecimal form as shown in 
figure 6-2. However, It is advisable to use a form consistent with the data being 
displayed. For instance, it makes sense to display memory containing program code in 
mnemonic form, but mnemonic form does not make sense for viewing memory 
locations containing random arithmetic values. The starting address for a mnemonic 
display should be the beginning of an opcode. 
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The display address will increment or decrement by units of one when using the up arrow or 
down arrow keys to view memory data in the mnemonic format. In this way the currently 
displayed mnemonic page can be aligned via inverse assembly, beginning at a new starting 
address. The I roll up I (or |ro// down] ) key in a mnemonic display will disassemble the next (or 



previous) address from the last (or first) displayed address, leaving the rest of the display 



unchanged. ( Roll up and up arrow, and mil down and down arrow keys, are equivalent in 



either absolute or blocked modes.) 



The 
will 



next page 



and 



prev page 



keys will replace all of the data with new date. The next page 



instruction address and succeeding instruction addresses and 

key will place the preceeding instruction 

mode. 



prev page 



prev page 



place the next 
corresponding data on the screen. The 

addresses and corresponding data on the screen. In some cases, in the 
there may be a slight delay before the data is placed on the screen. The delay results when 
the system steps backwards through the memory until sufficient data has been gathered to 
fill the screen. 




Figure 6-2. Memory Contents - Mnemonic 

Real number display/list. Data may be viewed as real numbers in either the short form 
(four bytes) or the long form (eight bytes). 
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d. Memory addresses may be displayed "offset" from the actual value. The address offset 
allows the actual addresses to be offset by a value specified by the user. If the value is 
correctly chosen, the address space displayed will start at location OOOOH and will 
correspond to the listing generated by the assembler or compiler. For example, if a 
module originating at address X is linked with other modules, it may be assigned a new 
starting address X+Y where Y is a value that depends on the number and size of the 
other modules being linked. Offset, therefore, allows the user to enter "Y" so that the 
addresses appear the same as in the source listing. 

Register Contents 

Register data is displayed as shown in figure 6-3. The program counter (PC) value can be 
offset by a specified value and the next program counter (Nxt PC) value will be offset by an 
equal amount. The offset is done for the same reason as described above for memory data. 




Figure 6-3. Register Contents 
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Trace Information 



Trace information may also be displayed or listed using the display/list command. Figure 6-4 
shows a trace memory display. 
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Figure 6-4. Trace Memory Display 



Global and Local Symbols 

These symbols may be viewed on the display. Local symbols are symbols defined in the 
source file for a single program module. Global symbols are those that are declared to be 
global in any source file, they are defined using the assembler pseudo instruction, GLB (or 
$GLOB\/AR+$ in the compiler). When the display command is used to examine either of 
these symbol types, the display will contain the symbol name, absolute address, and, for 
symbols located in emulation memory, their present value (and for local symbols the relative 
value of PROG, DATA, COMN). If the processor is running and is restricted to real-time runs, 
the values are displayed as asterisks (**). 
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Display and List Command Syntax 



The display and list commands initiate the display of local or global symbols, the contents of 
registers or memory, the contents of the trace memory. For the purpose of this discussion, 
display and list command options are treated as separate commands and are described as 
such on the following pages. 
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display/list 



SYNTAX 



display 
list 



(<FILE>) 
1 printer J 



global-Symbols 
local-symbols 
memory 
registers 
trace 



Default Value 

r 



Depending on what is listed, defaults may be tlie options selected for the previous 
execution of the list or display command. 



n 
I 

_i 



Examples: 



list printer memory 001 FH thru 005FH 
display registers 
list printer trace 

list JIM local_symbols_in KEEPrUSER 
list printer global-symbols 

list printer memory — (defaults to current information on the display.) 



FUNCTION 



The list command produces a copy of the information selected. The display command 
displays the information and allows the use of the 



ROLL UP 



ROLL DOWN 



PRBV PAGE 



NEXT PAGE 



, and in some cases the up and down arrow keys. The copy resulting from a list 
command can be either a listing file stored in the 64000 memory or a hard copy produced by 
the printer. If the information is written to an existing file, the old file is overwritten by the new 
information. 
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display/list 

(Cont'd) 



Parameters 

printer printer causes a hard copy to be printed. 

<FILE> <FILE> causes the information to be copied to either a new or an 

existing file identified by <FILE>. The syntax for <FILE> is 
discussed in Appendix A. 
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display/list global. symbols 



SYNTAX 




Default Value 

I I 

I none | 

I I 
I I 

Examples: 

display global-symbols 
list JOE global-Symbols 
FUNCTION 

The display/list global_symbols command displays the global symbols defined for the 
current absolute file and the logical addresses and present values of those symbols. Global 
symbols are looked up in the link-sym file which is generated during linking. If the link-sym 
file is not present, no symbols may be displayed or used in expressions. Global symbols are 
those that are declared to be global in the source file. When the list/display global_symbols 
command is used, the listing will include the symbol name, address, and its present value. 
The present values of symbols in emulation memory will be displayed. An asterisk (*) will be 
displayed in the value field for other symbols. 

Parameter 

gib-symb gib-symb represents the symbols and labels defined as global in 

one of the source programs from which the current absolute file 
was generated. When the [gibltymb^ soft key is pressed, 
"global -symbols" is displayed on the screen. 
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display/list loc-symb 



SYNTAX 





display 






< 




<FILE> 
^ printer 




1 local_symbols_in <FILE> 



Default Value 

I 1 

I none | 

Examples: 

display local_symbols_in TEMPI 
list printer local_symbols_in TEMPI 
list BOB local_symbols_in TEMPI 

FUNCTION 

The display/list loc_symb command displays the local symbols and their present values and 
relative mode as defined in the source (program, data, or common) <FILE>. Local symbols 
are looked up in the asmb_sym file generated during assembly or compilation. If the 
asmb_sym file is not present, no local symbols may be displayed or used in expressions. 

The present values of symbols in emulation memory will be displayed. An asterisk (*) will be 
displayed in the value field for other symbols. 

Parameters 

loc_symb Loc_symb refers to the symbols and labels defined as local in the 

source file identified by <FILE>. When the [joc_symbJ soft key is 
pressed, "local -symbols" is displayed. 

<FILE> <FILE> represents the source file that contains the local symbols to 

be displayed. Refer to Appendix A for the syntax requirements of 
<FILE> 
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display/list memory 



SYNTAX 



display 



list 



<FILE> 
printer 



memory[<MEMLIST>] 



[repetitively] [absolute] 

[repetitively] blocked 
[repetitively] real 
mnemonic 



"byte " 




_word. 




"byte " 




.word- 




long "1 


.short J 



[ offset- by<OFFSET>] 



where <MEMLIST> is defined as: 

<ADDRESS>[thru <ADDRESS>[,<ADDRESS>[thru <ADDRESS>., 
Default Values 



r 



Initial values are the same as specified by the command "display memory 0 blocked 
byte offset- by 0". 

Defaults are to values specified in previous display or list memory command. 
Repetitively must be specified each time display memory is issued. 
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display/list memory 

(Cont'd) 



Examples: 

display memory START mnemonic 

display memory 0 thru 100H, START thru START+5, 
500H, TARGET1, TARGET2 blocked word 

list memory 810H offset_by @:M0DULE1 

FUNCTION 

The display/list memory command shows the contents of the specified memory location or 
series of locations. The memory contents can be viewed either statically or repetitively 
(display memory only) and either in mnemonic or hexadecimal form. In addition, the memory 
addresses can be displayed offset by a value which allows the information to be easily 
compared to the file listing. 

Parameters 

<MEMLIST> <MEMLIST> describes the addresses of memory to be displayed. It 

consists of either a single address, in which case the memory 
display starts with that address, or a list of single addresses or 
ranges of addresses. 

repetitively causes the display to be periodically updated with the 
current contents of memory. The program must be interrupted in 
order to fetch the memory data and update the display (doing so 
one line at a time). 

mnemonic causes the program in memory to be disassembled. The 
mnemonic opcodes, memory locations, and associated operands 
are then displayed or listed. 

<OFFSET> causes the system to subtract the specified <OFFSET> 
from each of the actual absolute addresses before the addresses 
and the corresponding memory contents are displayed. The value 
of <OFFSET> can be selected such that each module in a program 
appears to start at address OOOOH. The display/list of the memory I 
contents will then appear similar to the assembly or compiler 
listing. 



repetitively 
(display only) 



mnemonic 



<OFFSET> 
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display/list registers 



SYNTAX 



display 



list 



<FILE> 
printer , 



" registers [offset_by <OFFSET>] 



Default Value 



r 



<OFFSET> Initially 0; thereafter previous value. 



L 



J 



Examples: 



display registers 

display registers offset_by 81 OH 

list JIM registers offset_by 0A10H 



FUNCTION 



The display/list registers command gives program counter value, the current contents of the 
processor's registers and, if a step has just been executed, the mnemonic of the last 
instruction. This process does not occur in real time; therefore, if the registers are to be 
displayed while the processor is running, the system must be configured to allow nonreal- 
time operations. 

The displayed value of the program counter can be offset from the actual value by a number 
which allows the register information to be easily compared to the assembled or compiled 
listing. 

Parameters 



<OFFSET> <OFFSET> represents the value by which the displayed program 

counter address is offset from the actual program counter address. 
The syntax for <OFFSET> is equivalent to the syntax for <\/ALUE> 
as described in Appendix A. 
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display/list trace 



SYNTAX 



< 


display 




trace 

• 




mnemonic 

absolute] status 


binary j 
hex > 
mnemonic j 




[ <FILE> ' 

list ' 

printer 
count 




absolute 
relative 




[offset- by <OFFSET>] 





Default Values 

I 1 

. Initial values are the same as specified by the command "display trace mnemonic | 
I count relative offset-by 0". | 

I <OFFSET> Initially 0; thereafter previous value. | 
Examples: 



display trace count relative 
display trace status binary 
list EXEC trace count absolute 
list printer trace offset_by 0100H 



FUNCTION 



The display/list trace command shows the contents of the trace buffer. The information can 
be presented as absolute hexadecimal code or in mnemonic form. The status captured by the 
analyzer can be displayed mnemonically, independent of the address and data information, 
or it can be displayed in hexadecimal or binary form. Addresses captured by analysis are 
physical addresses. 
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display/list trace 

(Cont'd) 



Figure 6-4 shows an example of a "display trace count relative" command. 

The offset_by option causes the system to subtract the specified <OFFSET> from the 
addresses of the executed instructions before the trace is displayed. With an appropriate 
entry for <OFFSET>, each instruction in the displayed trace will appear as it does in the 
assembled or compiled program listing. 

The display/list count command is used after a trace has been obtained to change the current 
display of time or state counts to one in which the counts are displayed either relative to the 
previous event or as an absolute count measured from the trigger event. If time counts are 
currently selected, the display count command causes an absolute or relative time count to 
be displayed. If the current display contains state counts, a relative or absolute state count 
results. 

Parameters 

mnemonic mnemonic directs the system to display trace information with 



opcodes in mnemonic format. 



absolute 



absolute directs the system to display the status information rather 
than mnemonic opcodes. 



status 



hex 



displays status information in hexadecimal form. 



binary 



displays status information in binary form. 



mnemonic 



displays status information in mnemonic form. 



<OFFSET> 



<OFFSET> represents the number by which the address displayed 
for an executed instruction is offset from the instruction's actual 
address. The syntax for <OFFSET> is equivalent to the syntax for 
<VALUE> as described in Appendix A. 



count 



absolute 



absolute causes the state or time count for each event of the trace 
to be displayed as the total count measured from the trigger event. 



relative 



relative causes the state or time count for each event of the trace to 
be displayed as the count measured relative to the previous event. 
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Chapter 

Analysis and Interactive Commands 



Introduction 



The analysis commands are used to specify the particular part of a program that is to be 
traced and displayed. The trace measurement may be made once and displayed statically or 
the same measurement may be made repetitively and the results continually updated. 



The trace command causes 256 states to be collected and stored in the trace memory. The 
trace memory is displayed relative to the trigger position. The trigger may occur at the 
beginning (after), at the middle (about), or at the end (before) of the trace memory contents. 
Note that the display is capable of listing only 1 6 lines per page, and therefore the 

keys are used to view all measured states. 



next page 


1 


roll up 


, or 


roll down 



prev page 



Emulation can interact with other modules of a multiple module system over the intermodule 
bus, or with external equipment through the BNC ports. Commands that involve interaction 
are: specify, execute, trace, stop_trace, and halt. Emulation can participate in coordinated 
measurements and can also begin execution of a program in concert with the initiation of a 
measurement. Chapter five contains details for specify, execute, stop_trace, and halt. Details 
of measurement interaction possibilities appear in this chapter under the heading 
"Interactive Measurement Selection". Details of the trace command follow. 
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trace 

SYNTAX 



trace 



again 



_[repetitively][<TRIGGER>[]<QUALIFIER>][<COUNT>][<BREAK>]_ 



where 

<TRIGGER> is defined as: 



after 

about 

before 



|<STATE> [occurs <#TII\/IES>] [or <STATE>]| 
I <RANGE_STATE> [occurs <#TIIVIES>] j 



<QUALIFIER> is defined as: 

|<STATE> [or <STATE>] 1 
I <RANGE_STATE> J 

<COUNT> is defined as: 

counting ( state <STATE 
I time 

<BREAK> is defined as: 



'I 



breal<_on j measurement_complete 
I trigger 

<RANGE_STATE> is defined as: 



address 



range <VALUE> thru <VALUE> 
not range <VALUE> thru <VALUE> 
not <VALUE> 



[ data<VALUE> ] [status<STATUS_EXPRESSION>l 
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trace 

(Cont'd) 



<STATE> is defined as: 

{ address <VALUE> [ data <VALUE> ] [ status <STATUS_EXPRESSION> ] } 



data <VALUE> j [ status <STATUS_ EXPRESSION 
I status <STATUS_EXPRESSION 

<STATUS_EXPRESSION> is defined as: 



<STATUS_IDENT> 



<VALUE> 



[and <STATUS_EXPRESSION>] 



Figure 6-4 shows tine result of a trace specification consisting of trigger (about), address 
(hexadecimal), qualifier (opcode), count (time), and no break. 



A shorthand syntax may be used when entering the information required by the <STATE> 
variable. The words "address", "data", and "status" can be omitted as long as commas are 
used to separate the fields which contain the entries for each state. For example, "address 
810H data OFFH status 14H" could be entered as follows: "810H,0FFH,14H". Likewise, 
"address 810H status 14H" could be entered as "810H„14H" using the shorthand syntax. 
Notice that when a particular field has no entry, commas must still be used to separate the 
fields. The first comma specifies the end of the address field, and the second comma 
specifies the end of the data field. 

The trigger and qualifier parts do not have the entire syntax described above. Only one may 
have a range on address and only one may have an 'or'ed term. The soft keys and grammar 
reflect this and will not allow entry of illegal specifications. 

In all cases the term <VALUE> is an expression consisting of addition, subtraction, 
multiplication, division, parentheses, numbers, and symbols. In hexadecimal, binary, and 
octal numbers don't cares (X) may be used. They may not, however, be combined with 
arithmetic operations and may not be used in the address <VAHJE> of a <RANGE_STATE>. 

<STATUS_IDENT> is any one of the predefined mnemonic status values. Using "and" 
capability, status identifiers and/or values can be combined. It is possible, for example, to 
enter status OOOOOOOOB and status 11111111 B; a combination that will result in the error 
message, "Status expression error". 
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The "and" function for status expressions operates bitwise on values entered, or on the 
predefined values of the mnemonic status identifiers. Table 7-1 defines the results of the 
"and" function for any bit. 

Table 7-1. "And" Function Results 





X 


0 


1 


X 


X 


0 


1 


0 


0 


0 


E 


1 


1 


E 


1 



Where X is the symbol for a "don't care" bit, and E represents an invalid entry that will result 
in the message "Status expression error". 



Using Analysis Commands 



Analysis may be performed either by first initiating the program run and then specifying the 
trace parameters or by specifying the trace parameters first and then initiating the program 
run. In either case, once a trace command is initiated, the analysis module monitors the 
system buses of the emulation processor to detect the states specified in the trace command. 
When the trace specification has been satisfied, a message will appear on the status line 
showing "trace complete". At that time the contents of the trace memory can be displayed. If 



the trace memory contents exceed the page size of the display, the next page 



prev page 



roll up , or roll down keys may be used to display all the trace memory contents. 



Trigger and storage qualification can be specified without initiating a trace by using the 
specify trace command, and traces can be initiated without altering the trigger and storage 
qualifications by using the execute command. 

The trace command consists of the components described in the following paragraphs. 

a. <TRIGGER> - The "trigger" is the event on the emulation bus to be used as the 
starting, ending, or centering event for the trace. 

b. <QUALIFIER> - The storage specification determines which of the traced states will be 
stored in the trace memory for display upon completion of the trace. The trace 
memory can be be filled by those states which occur immediately before or 
immediately after the specified trigger event, or half of the memory can be filled by 
states which precede the trigger and half by those which follow the trigger event. 
Events can be selectively saved by pressing trace only and entering the specific events 
to be saved. When this option is used, only the indicated states occurring in the 
specified position relative to the trigger are stored in the trace memory. 
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c. <COUNT> - The count option specifies whether time or the occurrence of a state will 
be counted during the trace. The data can be displayed either "relative" to the count at 
the previous stored state, or "absolute" with respect to the trigger. All count 
measurements can be displayed in either absolute or relative mode. The absolute 
count is the total count from the trigger to each measured state. A plus sign (+) 
proceeding the trace number indicates that the state occurred after the trigger state. A 
minus sign (-) indicates that the state has occurred before the trigger state. 

The "relative count" mode displays the count between consecutive states stored in the 
trace buffer. It can be used to measure execution times of subroutines and instructions 
or the time between the occurrence of the same state in the execution of a program. 

d. <BREAK> - The break specification causes an exit from the executing program to the 
background at a predetermined point in the emulation program. 

e. again - Entry of the "again" parameter causes the trace to be performed again using 
the previous trace parameters. 

f. repetitively - Entry of the "repetitively" parameter causes a new trace to be initiated 
after the results of the previous trace are displayed. The trace will continue until a 
stop_trace or a new trace command is issued. 

Interactive Measurement Selection 



The internal analysis unit can interact with other measurement equipment during emulation 
through either or both of the BNC output ports located on the back of the development 
station. The analysis unit can also interact with other cardcage analysis modules through the 
1MB connector located at the top of the analysis card. The following questions appear during 
configuration. 

Modify interactive measurement specifications? no (yes) 

If interaction is desired or if a previously defined interactive specification is to be 
modified, this question allows the analysis interaction specification format to be 
reviewed and modified as necessary. If no modification is desired, the "no" response 
should be selected. The Interactive Measurement questions will then be skipped, 
leaving the responses in their default or previously defined states. 
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If this question is answered "yes", the following series of of questions will be presented in 
sequence. 

(a) PORT 1? off (drive) 

The "drive" option causes the internal analysis unit to output a pulse to Port 1 when the 
analysis trigger is encountered. This function is useful for arming or triggering an 
external measurement instrument such as a scope or logic analyzer. 

If "off" is selected, PORT 1 has no function. 

(b) PORT 2? off (drive) 

The "drive" option causes the internal analysis unit to output a pulse to Port 2 when the 
analysis measurement is complete. This function is useful for arming or triggering an 
external measurement instrument such as a scope or logic analyzer. 

If "off" is selected. Port 2 has no function. 

(c) Active edge? rising (falling) 

This question is only encountered if either Port 1 or Port 2 is configured to operate in 
the "drive" mode. The response specifies the polarity of the drive pulse which will be 
generated at the active ports. 

"Rising" specifies a positive going output pulse whereas "falling" specifies a negative 
going output pulse. The polarity specification applies to both ports if both are active. 

The following questions refer to the lines available through the 1MB connector on the internal 
analysis board, and on other interacting modules. 

(d) Trigger enable? off (drive) (receive) 

1. No 1MB interaction over the trigger enable line. 

If the "off" option is selected, internal analysis will not interact with the trigger 
enable line. 

2. Drive 1MB Trigger Enable 

Selection of the "drive" option causes internal analysis to drive the 1MB trigger 
enable line when analysis finds the internal trigger point or receives an external 
trigger. 
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3. Receive 1MB Trigger Enable 

Selection of the "receive" option prevents internal analysis from finding its internal 
trigger point until some other module has driven the trigger enable line. 

The trigger enable options are the only 1MB functions available when using the 40 channel 
(64300A) internal analysis board. With the 48 channel (64302A) board the following additional 
options become available: 

For 48 channel analysis there is one function that is always used whenever any other 
interaction is desired. This is the function of receiving the 1MB Master Enable line in orderto 
allow synchronous initiation of the multiple modules. Internal analysis will select the correct 
option for this function depending on the options chosen for the other functions. 

(e) External trigger? off (drive) (receive) (drive and receive) 

1. No interaction over 1MB trigger line. 

When "off" is selected, internal analysis will not participate in any interaction over 
the 1MB trigger line. 

2. Drive 1MB trigger 

Selection of the "drive" option causes internal analysis to drive the trigger line 
when it finds its internal trigger point. 

3. Receive 1MB trigger 

Selection of the "receive" option allows internal analysis to trigger either on 
finding its internal trigger point or when another module drives the 1MB trigger 
line. 

4. Drive and receive 1MB trigger 

Internal aniaysis will search until it finds its internal trigger or until another module 
drives the trigger line. Regardless of the source of the trigger, once internal 
analysis has triggered, it begins to drive the 1MB trigger line. 

(f) Internal trigger? on (off) 
1. Enable internal trigger 

If the "on" option is selected the internal triggering mechanism is enabled. This 
means that triggers specified via a "trace" or "specify trace" command will cause 
internal analysis to trigger if they are enabled (see trigger enable option above). 
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2. Disable internal trigger 

If the "off" option is selected, then the internal triggering mechanism is disabled 
and will not cause a trigger. Thus triggers specified by "trace" or "specify trace" 
command will be ignored and internal analysis will only trigger when it is receiving 
an external trigger. 

(g) Delay clock? off (drive) 

1. No interaction on delay clock line 

If the "off" option is selected then internal analysis will not interact over the delay 
clock line. 

2. Drive delay clock line 

Selecting the "drive" option causes internal analysis to drive the delay clock line 
once it has triggered, whether by an internal trigger or a received external trigger. 
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Chapter 8 

Simulated I/O 



Introduction 

The "Simulated I/O" feature of the 64000 System allows the user to develop programs for, 
without actually using, the target system's I/O hardware. To do this, the 64000 system's I/O 
hardware is used to "simulate" the target system's I/O hardware. This provides a double 
benefit. First, programs may be developed concurrently with hardware development, and 
second, if the target systems hardware exists but is not available to the programmer, program 
development can continue uninterrupted. 

The following 64000 system hardware may be used to "simulate" the target system hardware 
during user-program development. (The 64000 hardware is listed in the order of description.) 

• Printer 

• Display 

• Keyboard 

• Disc 

• RS-232 Communications Channel 

Simulated I/O is described in this section as follows. First an overview is presented. The 
overview describes the common attributes of the five simulated I/O interfaces, and then 
briefly, the interfaces themselves. The intent of the overview is to acquaint the reader with the 
simulated I/O features. 

Following the overview, each interface is described in detail. The intent of the detailed 
descriptions is to provide sufficient information to allow a userto write the programs that will 
interface with the 64000 I/O devices. Following the detailed descriptions is a list of error 
codes, sample programs and file formats. 
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After the I/O programs have been written, assembled or compiled, and linked, they may be 
incorporated into an emulation configuration, then executed and tested. 

Emulation configuration is described in Chapter 4 of this manual. Running and testing the 
programs is done with the commands described in Chapters 4 thru 7 of this manual. 

Overview 

A general description of each of the simulated I/O interfaces is described in the following 
paragraphs. However, all of the interfaces have common attributes. These are described first. 

Common Attributes 

Each simulated I/O interface requires a unique memory location to which all I/O 
handshaking codes are sent by both the user and the 64000 programs. The address for this 
location is generically referred to as the control address, or CA. The 64000 samples these 
addresses periodically looking for commands. Location CA must be initially defined in the 
users program and in the emulation configuration. If more than one simulated I/O interface is 
to be implemented, then the user must make sure that each I/O program assigns a unique 
address for the CA. Additionally, the user program must allow for contiguous buffer spaces 
following the CA. The exact amount, and use, of this buffer space is determined by the type 
of I/O interface. These requirements are specified in the detailed descriptions of the 
interfaces. 

The addresses for the different CA locations are entered into the 64000 program during 
emulation configuration. The processor must not be restricted to real time runs when using 
simulated I/O. The CA locations must be located in memory space assigned as either user 
RAM or emulation RAM. It is recommended that the CA locations be in emulation RAM since 
this will allow the user programs to run faster. Mapping the CA locations to user RAM will 
cause the emulator to go to the monitor program while polling the CA locations for 
commands and or data. 

Certain of the I/O codes sent to location CA must also include supplemental information. 
This supplemental information is contained in the locations following CA, i.e., CA+1 thru 
CA+n. The supplemental information must be placed in locations CA+1 thru CA+n BEFORE 
the corresponding control code is placed in CA. If this is not done, the 64000 may respond to 
the control code in CA before the supplemental data is set into locations CA+1 thru CA+n. 

The user program must initiate the request to open the simulated I/O interface. To do this, 
after setting up the supplemental information in locations CA+1 thru CA+n, the user program 
places the appropriate code into location CA. (Code 80H opens all interfaces except the disc 
file where it creates a file.) If the 64000 program successfully executes the request, it returns 
the appropriate code to location CA. (Usually a 00 is returned, but not always.) If the 64000 
program cannot execute the request, an error code is returned to location CA. A group of 
predefined error codes is used. Within this group only a portion of the codes apply to each 

8-2 EMULATOR/ANALYZER 6809/6809E 



interface. These error codes are defined in general terms in Table 8-8 which is located toward 
the end of this chapter. For those interfaces where the error codes also have specific 
meanings, the meanings are defined in the detailed descriptions of the interface. When the 
user is finished with the system resources, he should "close" the appropriate interfaces with 
the proper commands. All devices will automatically be closed by an "end" command or by 
execution of a reset-reset. 

Printer I/O Interface (See Figure 8-1) 

This is the simplest of the five I/O interfaces. Only three user-control codes are used to 
interface with the printer. These are: (1) open printer file, (2) write to the printer, and (3) close 
printer file. 

A buffer space contiguous to location CA contains a value indicating the number of bytes 
(characters) to be printed followed by the characters themselves. 

Display I/O Interface (See Figure 8-2) 

This is somewhat more complex than the printer I/O interface since it has five user control 
codes. These codes are used to: (1) open the display file, (2) roll to and write line 18 (this is 
used to scroll lines up on the display), (3) select a starting line and column, (4) write from the 
selected line and column, and (5) close the display. 

Depending upon the control code issued, a buffer space contiguous to location CA is 
required to hold one of the following parameter groups: (1) line length in bytes followed by 
the bytes to be displayed, (2) line and column number at which record display is to begin, or 
(3) record length in bytes followed by the record bytes to be displayed. The open and close 
codes use no additional buffer space other than location CA. 

Keyboard I/O Interface (See Figure 8-3) 

The keyboard interface uses two user control codes and two keyboard input command word 
codes. Additionally, the 64000 returns one of 24 keyboard output command word codes. 

The user control codes are used to open or close the keyboard interface file. The two 
keyboard input command codes are used to either: (1) clear the currently displayed line upon 
receipt of a keyboard character, or (2) append the character to the existing line. 

When the keyboard file is opened, a buffer space contiguous to location CA is required to 
hold the keyboard input command word and the maximum record length specification. This 
specification defines the maximum record length that will be accepted from the keyboard. 
Thus, the buffer must be large enough to accept the keyboard output parameters and the 
maximum record length specified. 

The keyboard output command word defines the manner in which the input line was 
terminated or the status of the keyboard output record. The output record consists of ASCII 
coded character bytes. 
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Disc Files I/O Interface (See Figure 8-4) 




The disc file simulated I/O control codes can be used to 
access critical system files. Extreme care should be used if 
any of the following types of files are accessed: 



Emulation Command Files (Type 6) 

Linker Command Files (Type 7) 

Linker Configuration Files (Type 8) 

Incorrectly accessing these files may destroy them and cause 
serious system problems! 



The simulated disc file interface uses ten user control codes. These codes allow the user 
program to: (1) create, open, close, or delete a file; (2) advance to, backup to, or randomly 
select a record position within a file; (3) automatically select record position 1 in the file; and 
(4) read from, or write into any selected record position in the file. The user may also assign a 
different file name to be associated with an already existing CA. 

Depending upon the control code issued, a buffer space contiguous to location CA is 
required to hold one of the following parameter groups: (1) file type number, (2) disc number, 
(3) record number, (4) maximum number of words to read or write, or (5) the actual number of 
words read or written, followed by the words themselves. 

No buffer space is required following the control codes used to close the file and to 
automatically select record position 1 in a file. 

RS-232 I/O Interface (See Figure 8-5) 

This is the most complex of the five I/O interfaces. To use this interface, the following distinct 
events MUST be implemented between the user and 64000 programs: (1) the RS-232 
interface must be opened; (2) the 8251 Universal Synchronous/Asynchronous, Receiver/ 
Transmitter, or USART, is initialized; (3) using the appropriate command word, an 8251 
operating mode is selected; (4) data may be written to, or read from, the 8251; and (5) when 
data transfer is complete, the RS-232 file may be closed. 
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To implement the interface, tiie user program must allow for control space contiguous to 
location CA as shown in figure 8-5. During 8251 initialization, locations CA+1 thru CA+5 hold 
the command and status words used to initialize and select the operation of the 8251. 

The user program may read or write single bytes or multiple-byte records. When reading or 
writing single bytes, the single byte is passed through location CA+I. If multiple byte records 
are to be handled, the user program must set up read and write buffers as shown in 
figure 8-5. 

When writing multiple byte records, locations CA-l-6 thru CA+22 hold the write buffer 
pointers and the actual number of bytes sent by the 8251. This data is used interactively 
between the user and 64000 programs to transfer write data from the users program, via the 
users and 64000 write buffers, to the 8251. 



When reading multiple-byte records, location CA.-I-23 thru CA+39 hold the read buffer 
pointers and the actual number of bytes received by the 8251. This data is used interactively 
between the user and 64000 programs to transfer read data from the 8251, via the 64000 and 
users read buffers, to the user program. 

The read and write buffers may be updated separately or together by the user program. 



USERS 

PRINTER 

ROUTINE 



CONTROL 
CODES 



PRINT 
DATA 
240 

BYTES 
MAX 



CA 



CA-1 



CA+n 



CONTROL 
CODES 



PRINTER 
DATA 



64000 
PROGRAM 



64000 
PRINTER 



USERS PRINTER I/O 
CONTROL/DATA BUFFER 



Figure 8-1. Simulated Printer I/O Interface Diagram 



CONTROL 
CODES 



CONTROL 



USERS 

DISPLAY 

ROUTINE 



DISPLAY 

DATA 

256 

BYTES 
MAX 







CODES 


CA 




CA 










DISPLAY 






DATA 


CA 







64000 
PROGRAM 



64000 
DISPLAY 



USER'S DISPLAY I/O 
CONTROL/DATA BUFFER 



Figure 8-2. Simulated Display I/O Interface Diagram 
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USERS 
KB 

ROUTINE 



CONTROL 
CODES 



COMMAND 
WORDS 



KB DATA 
BYTES - 
240 MAX. 



CA 



CONTROL 
CODES 



COMMAND 
WORDS 



64000 
PROGRAM 



COMMAND WORDS 



KB DATA 



64000 

KEYBOARD 



USERS KB I/O 
CONTROL/DATA BUFFER 



Figure 8-3. Simulated Keyboard I/O Interface Diagram 



USERS 
DISC 
FILE I/O 
ROUTINE 
& FILES 



CONTROL 
CODES 



READ/WRITE 
FILE OR 
RECORD ID 

- OR - 
R/W DATA 
WORDS. 
128 WORDS 
(256 BYTES) 
MAX 



CA 



CA-1 



CONTROL 
CODES 



READ/WRITE 
.DATA 



64000 
PROGRAM 



64000 
DISC 



USER S DISC I/O 
CONTROL DATA BUFFER 



Figure 8-4. Simulated Disc File I/O Interface Diagram 
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WRITE 
BYTES 


USER'S 
WRITE 
BUFFER- 


WRITE 
BYTES ^ 


USER'S 
WRITE 
BUFFER" 
(256 BYTES 
MAX) 


WRITE 
BYTES 









64000 CONTROL 



USER'S 
PROGRAM 



CONTROL 
CODES 



INITIALIZATION 
& STATUS 



WRITE 
CONTROL 



READ 
CONTROL 



CA (CNTRL 
ADDR) 



8251 

INITIALIZATION 
BUFFER 



WRITE 

CONTROL 

BUFFER 



READ 

CONTROL 

BUFFER 



USER'S RS-232 
CONTROL BUFFER 



XMIT 
DATA 



64000 PROG 
8. 

READ/WRITE 
INTERRUPT 
ROUTINES 



8251 
USART- 



REC 
DATA 



64000 CONTROL 



READ 
BYTES 


USER'S 

READ 

BUFFER" 




64000 
READ 
BUFFER" 


READ 
BYTES 









*USART = Universal Synchronous/ Asynchronous Receiver/Transmitter, 

"Buffers are required only if records are to be read or written. Single bytes do not require these buffers. 



Figure 8-5. Simulated RS-232 I/O Interface Diagram 
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Printer I/O Interface 

The following paragraphs describe the events which must be implemented between the user 
and the 64000 program for printer I/O to occur. The events are: 

• Open Printer File 

• Write to Printer 

• Close Printer File 

The above events, the corresponding control codes, and parameters, where applicable, are 
summarized in table 8-1. 

NOTE 



During the time that a simulated I/O printer file is open, no 
other user can access the printer. Thus, be sure to close the 
file when finished. 



Open Printer (80H) 

Before using a "write to printer" code, the user program must request that the printer 
interface be opened. This is done by placing code 80H into location OA. 

NOTE 



OA represents the memory location to which all printer I/O 
"handshaking" codes are sent by both the user and the 64000 
program. The actual address for the printer is defined in the 
user program and entered into the 64000 program during the 
configuration of the emulation CMDFILE. Each I/O interface - 
printer, RS-232, display, etc. - requires its own unique OA 
address. 

Certain of the I/O codes sent to location OA must also include 
supplemental information. This supplemental information is 
generally contained in the locations following CA, i.e., CA+1 
thru CA+n. The supplemental information must be placed into 
locations CA+1 thru CA+n BEFORE the corresponding 
control code is placed in CA. If this is not done, the 64000 may 
respond to the control code in CA before the supplemental 
data is set into locations CA+1 thru CA+n. 
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The 64000 program responds by opening the printer file and returning a 00 to location CA. If 
the file cannot be opened, error codes are returned as shown in table 8-1. 

After the file is opened, the user program may issue a write-to-printer code as described in 
the next paragraph. 

Write to Printer (82H) 

To send a write record to the printer, the user program places the following parameters into 
locations CA+1 thru CA+n and then after setting up locations CA+1 thru CA+n, places code 
82H into location CA. 

The record length in bytes is entered into location CA+1. The record length must be a 
minimum of two bytes and may be a maximum of 240 bytes in two byte increments. That is - 
the record must always contain an even number of bytes. Odd bytes should be padded with a 
space (20H). 

Locations CA+2 thru (CA+2)+n contain the ASCII codes of the character to be printed. 

The 64000 responds by supplying the write record to the printer and returning a 00 to 
location CA. The 64000 automatically sends a carriage return/linefeed to the printer 
following the user data. If the write-to-printer record is not accepted, an error code is 
returned as listed in table 8-1. 

Close Printer Fiie (81 H) 

The user program closes the printer file by placing code 81 H into location CA. The 64000 
responds by closing the file and returning code 00 to location CA. The 64000 will perform a 
form feed automatically. 

If the close file is not accepted, an error code is returned to location CA as shown in table 8-1 . 
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Table 8-1. Printer I/O Codes 



Request 
Name 



OPEN 

PRINTER 

FILE 



CLOSE 

PRINTER 

FILE 



WRITE 
TO 

PRINTER 



User Program 
Request 



Address 

OA 



OA 



OA 
CA+1 



CA+2 
i 

(CA+2) 
+n 



Contents 

80H 



81 H 



82H 

Record 
Length 
in bytes 
(240 max.) 



Record 
byte 1* 

I 

Record 
byte n* 



64000 Response To: 

Valid User Request Invalid Request 
Address Contents Error Code 



CA 



CA 



CA 

The 64000 
accepts 
the record 
and causes 
it to be 
printed. 



00 



00 



00 



01 thru 08 

09: file is 
already open. 

10-14: NA 

01 thru 08 

09: file is 
already closed. 

10-14: NA 

01 thru 08 

09: file is 
not open. 

10, 11, 13 
& 14: NA 



12: Record 
length ex- 
ceeded 240 
bytes. 



*AII display characters must be formatted in ASCII code. A code greater than OFOH will not be 
accepted by the 64000 program. 

NA= Not Applicable. 

See table 8-8 for complete error code listing. 
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Display I/O Interface 

The following paragraphs describe the events which must be implemented between the user 
and the 64000 programs for display I/O to occur. The events are: 

• Open Display File 

• Roll To / Write line 18 (scroll and write) 

• Select line and column 

• Write from selected line/column 

• Close Display File 

The above events, the corresponding control codes and parameters, where applicable, are 
summarized in table 8-2. Display techniques are shown in figure 8-6. 

NOTE 



During the time that the simulated I/O display file is open, the 
standard 64000 keyboard has no control over the display. 

To regain control, press the simulate softkey which closes the 
file. If the keyboard file is open, it, too, is closed when the 
softkey is pressed. 



Open Display File (80H) 

Before any writing can be done on the display, the user program must request that the 
display file be opened. This is done by placing code 80H into location OA. 

NOTE 



OA represents the memory location to which all display I/O 
"handshaking" codes are sent by both the user and the 64000 
program. The actual address for the display I/O OA is defined 
in the user program and entered into the 64000 program 
during the configuration of the emulation CMDFILE. Each I/O 
interface - display, RS-232, printer, etc. - requires its own 
unique OA address. 



EMULATOR/ANALYZER 6809/6809E 8-11 



Certain of the I/O codes sent to location CA must also include 
supplemental information. This supplemental information is 
generally contained in the locations following CA, i.e., CA+1 
thru CA+n. The supplemental information must be placed into 
locations CA+1 thru CA+n BEFORE the corresponding 
control code is placed in CA. If this is not done, the 64000 may 
respond to the control code in CA before the supplemental 
data is set into locations CA+1 thru CA+n. 



The 64000 program responds by opening the display file, and returning a 00 to location CA. If 
the file cannot be opened, error codes are returned as shown in table 8-2. 

After the file is opened, the user program may write on the display as described in the 
following paragraphs. 

Roll To/Write Line 18 (82H) 

This command allows writing to be initiated at the bottom of the display. Sequential Roll 
Up/Write Line 18 commands cause the previously written line 18 to roll to line 17, etc. Thus, 
writing is always done on the bottom line and the previously written lines are shifted up as 
each new line 18 is written. 

To cause the display to roll up and begin writing on line 18, the user program places the 
following parameters into location CA+1 thru CA+n, and after setting up locations CA+1 thru 
CA+n, then places code 82H into CA. 

The line length in bytes is entered into location CA+1 . The line length must be a minimum of 
two bytes and may be a maximum of 80 bytes, in two byte increments. That is, the line must 
always contain an even number of bytes. If the user writes an odd number of bytes, the 64000 
will pad the line with a null. 

Locations CA+2 thru (CA+2)+n contain the ASCII codes of the characters to be written on 
line 18. The 64000 responds by storing this data in a display buffer and returning a 00 to 
location CA. A delay may occur before the program rolls up and writes to line 18. Thus, a 
program wait may be required. If writing cannot be done, especially if write roll/column is 
used (roll/column does not use delay), an error code is returned as listed in table 8-2. 

After initially rolling up and writing on line 18, subsequent Roll Up/Write Line 18 commands 
cause the previously written line 18 to roll up to line 17, line 17 to roll to line 16, etc. Although 
the 64000 responds almost immediately with a 00 in CA, the actual scrolling of a line can take 
up to 200 msec. The 64000 will accept other commands during this time. Future scrolls are 
buffered and performed in sequence. Row/Column writes will be performed immediately and 
may be scrolled if a previous scroll has not been completed. 
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Select Starting Line/Column (83H) 

The user programs may specify the line number and column number at which writing, when 
indicated, will start. To do this, the user program places the line number (1 thru 18) into 
location CA+1 , the column number (1 thru 80) into location CA+2, and then places code 83H 
into location CA. 

The 64000 responds by storing the line and column number and returning code 00 to location 
CA. The line and column numbers are stored until either writing is initiated (code 84H) or the 
display file is closed. 

If the line and column numbers are not accepted by the 64000 program, an error code is 
returned to location CA as listed in table 8-2. 

Figure 8-6 shows the display techniques. 

Write From Starting Line/Coiumn (84H) 

Before writing can be initiated, a starting line number and column number must be specified 
by the user program. After this is done, writing may be initiated as follows: the user program 
initiates writing by placing the record length (i.e., number of characters to be displayed) into 
location CA+1, the actual display characters (ASCII codes) into locations CA+2 thru 
(CA+2)+n, and then places code 84H into location CA. 

The maximum record length is 255 bytes. The display characters must be formatted in ASCII 
codes. The 64000 program will not accept a display code greater than OFOH. 

The 64000 responds by displaying the record beginning at the starting line and column 
specified by code 83H. If the record exceeds the length of the starting line, writing continues 
at column one of the next line, etc. 

If the 64000 cannot initiate writing as requested, an error code is returned to location CA as 
shown in table 8-2. 

Close Display File (81 H) 

The user program closes the display file by placing code 81 H into location CA. The 64000 
responds by closing the file and returning code 00 to location CA. 

If the close file is not accepted, an error code is returned to location CA as shown in table 8-2. 

Pressing the inverse video "simulate" key or performing a "reset-reset" will automatically 
close the display. Closing the display also closes the keyboard. 
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Table 8-2. Display I/O Codes 



Request 
Name 



OPEN 

DISPLAY 

FILE 



User Program 
Request 



Address 

CA 



Contents 

80H 



64000 Response To: 



Valid User Request 



Address 

CA 



Contents 

00 



The 64000 program 
opens the file and 
clears the display 



Invalid Request 

Error Code 

01 thru 08 & 14 

09 code >84H 
or file is open 



10 thru 13: NA 



CLOSE CA 81 H CA 00 01 thru 08 & 14 

DISPLAY 

FILE 09: file is 

already closed. 

10 thru 13: NA 



ROLL 

TO/ 

WRITE 

LINE 

18 



CA 
CA+1 



CA+2 



(CA+2) 
+n 



82 H 

Line 
length 
in bytes 
(80 max) 



Line 
byte 1* 



CA 



00 



Line 
byte n* 



The 64000 program 
stores this data 
in a display 
buffer. A delay 
may occur before 
rolling to and 
writing on line 18 
actually occurs. 
A program wait 
may be required. 
If successive 
line 18's are 
written, then 
the proceeding line 
18 is rolled to 
line 17, 17 to 16, 
etc. 



01 thru 08 & 14 

09: file is not 
open 

10, 11, & 13: NA 



12: Invalid 
record length 
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Table 8-2. Display I/O Codes (Cont'd) 



Request 
Name 



SELECT 
STARTING 
LINE/ 
COLUMN 



User Program 
Request 



Address 

CA 
CA+1 

CA+2 



Contents 

83H 

Line # 
(1-18) 

Column 
Number 
(1-80) 



64000 Response To: 

Valid User Request Invalid Request 
Address Contents Error Code 



CA 



00 



The 64000 program 
stores the line 
and column numbers 
until a write 
line/column re- 
quest is issued 
or the file is 
closed. 



01 thru 08 & 14 

09: File is not 
open 



10, 12 & 13: NA 

11: Invalid line or 
column number. 



WRITE 
FROM 
STARTING 
LINE/ 



CA 
CA+1 



CA+2 
I 

(CA+2) 
+n 



84H 

Record 
length 
in bytes 
(255 Max) 



Record 
byte#1 
1 

Record 
byte n* 



CA 



00 



The 64000 program 
displays the record 
starting at line/ 
column selected by 
code 83H. If record 
exceeds one 
line, writing con- 
tinues at column 
1 of next line,etc. 
See figure 8-6. 



01 thru 08, 13 
& 14 

09: file not 
open. 

10 & 12: NA 

11: line/column 
not specified 
by 83H. 



*AII display characters must be formatted in ASCII code. A code greater than OFOH will 
not be accepted by the 64000 program. 

NA= Not Applicable. 

See table 8-8 for complete error code listing. 
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COLUMN # s 




2 B/C fc-C 

3 C 

4 C etc 




64000 DISPLAY 



DISPLAY 

LETTER MEANING 

A Code 82H automatically causes the display to roll to line 18. Up to 80 characters, in two 
byte increments, may be written on the line. Sequential Roll To / Write Line 18 
commands cause the previous line 18 to roll to line 17, line 17 to roll to line 16, etc. 

B/C B is the point (line 2, column 5) defined by code 83H at which writing will begin. C is 
the statement which is defined by code 84H and begins at point B. There is no limit on 
the record length defined by 84H. If the record exceeds the length of line 2, it is 
continued on line 3 at column 1, etc. 



Figure 8-6. Display Techniques 
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Keyboard I/O Interface 

The operation of the keyboard I/O interface is described in the following four phases: 

• User Program Requests Keyboard Read 

• 64000 Response to Keyboard Read Request 

• 64000 Detects Positive KB Output Command Word 

• User's Program Detects 00 in OA 

Each of the above phases corresponds to a significant interaction which must be 
implemented between the user program and the 64000 program for keyboard I/O to occur. 

The keyboard I/O interface events are summarized in figure 8-7 and table 8-3. 

NOTE 



To automatically close the simulated I/O keyboard file and 
return the keyboard to standard operation, press the 
[sTmuiale] softkey. If the display file is also open, it, too, is 
closed when the softkey is pressed. 



User Program Requests Keyboard Read (80H) 

Before any other keyboard operation can be initiated, the user program must request that the 
KB I/O interface be opened. This is done by first placing the KB-input-command word and 
the maximum record length specification into the KB I/O buffer as shown in Phase I of figure 
8-7. Then, after setting up locations CA+1 thru CA+n, code 80H is placed into location CA of 
the buffer. 

NOTE 



CA represents the memory location to which all KB I/O codes 
are sent by both the user program and the 64000 program. 
The actual address of CA is defined in the user program and 
entered into the 64000 program during the configuration of 
the emulation CMDFILE. Each I/O interface - keyboard, 
RS-232, printer, etc., requires its own unique interface. 
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Certain I/O codes sent to location CA must also include 
supplemental information. This supplemental information is 
contained in the locations following CA, i.e., CA+1 thru CA+n. 
The supplemental information must be placed into locations 
CA+1 thru CA+n BEFORE the corresponding control code is 
placed into CA. If this is not done, the 64000 may respond to 
the control code in CA before the supplemental data is set 
into locations CA+1 thru CA+n. 



The KB-input-command word is placed in buffer location CA+1. This word contains either a 
"-1" or "-2" code. A "-1" code causes the current line not to be cleared on the first character 
(i.e., the current keyboard characters are appended to any characters already displayed on 
the same line). A "-2" code causes the current line to be cleared on the first character (i.e., 
previously displayed characters are erased from the line and only the current keyboard 
characters are displayed). 

The maximum record length specification is placed in buffer location CA+2. This is the 
maximum record length (i.e., number of keyboard characters) that the user program will 
accept from the keyboard. The record length specification may specify up to 240 characters 
(3 lines on the 64000 display). However, the keyboard may transmit more or less characters 
than this specification. If the number of characters transmitted exceeds the record length 
specification, the user program is informed of this by an applicable code in the KB-output- 
command word as described below. 

64000 Response to Keyboard Read Request 

The 64000 program responds to the KB read request by storing the KB-input-command word 
and record length specification, and by placing code 82H into location CA as shown in figure 
8-7. 

The 64000 program sets the KB-output-command word to the same code specified in the KB- 
input-command word (-1 or -2). 

The 64000 then begins monitoring the keyboard until an output command word is detected. 
The result of this detection is described in the following paragraphs. 

64000 Detects Positive KB-Output-Command Word 

The keyboard may send either a KB-output-command word by itself or a command word 
followed by one or more keyboard characters. In either case, when a KB-output-command 
word is detected, the 64000 program places the word, and if applicable, other data into the 
KB I/O buffer as shown in figure 8-7 (Phase III). The KB output word, which is always sent, is 
placed in buffer location CA+1. 
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The 64000 program places a 00 in location CA to indicate to the user program that either a KB 
command and/or data is now available. 

If keyboard characters are also sent and if a "lost character" was generated then the "lost 
character" is placed into location CA+2. (How a "lost character" is generated is described 
later.) Also, when keyboard characters are sent, the actual number of characters in the string 
(i.e., actual record length) is placed into location CA+3. The keyboard characters themselves 
(ASCII coded bytes) are placed into locations CA+4 thru (CA+4)+n. 

The KB output command in location CA+1 may be any one of the codes shown in table 8-4. 
Two of these codes, 8 and 24, will occur only if the actual record length from the keyboard 
exceeds the maximum record length specification. If either of these codes is generated, then 
location CA+2 contains the ASCII code of the surplus or lost character that exceeded the 
specified record length. A lost character may be generated in either of two ways: 

a. When characters are entered as a continuous string and the string exceeds the 
specified record length. For this case, the first character to exceed the specified record 
length is placed in "lost character" location CA+2. If typing continues, each individual 
surplus character is placed into the "lost character" location CA+2 replacing the 
previous character. Thus, the last "lost character" entered remains in location CA+2. 

b. When a character is inserted into a full record. For this case, the character at the end of 
the already full record is placed into "lost character" location CA+2. If additional 
characters are inserted, each succeeding end character is placed into CA+2, replacing 
the previous character. 

User's Program Detects 00 in CA 

After detecting a 00 in location CA, the user program takes the data from the KB I/O buffer 
and places either 80H or 81 H into location CA. The results of each of these response codes 
are as follows: 

a. 80H Response Code - Read Keyboard I/O 

If the user program responds with code 80H, the KB-input-command word and record 
length specifications must be supplied by the user program as shown in figure 8-7. 

The 64000 program responds by again reading the keyboard. 

b. 81 H Response Code - Close KB I/O 

If the user program responds with code 81 H, the 64000 program closes the KB I/O 
interface. This command will also close the display file if it was open. 
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Table 8-3. Keyboard I/O Interface Codes 



Request 
Name 



User Program Request 
Address Contents 



64000 Response To: 
Valid User Request Invalid Request 



Address 



Contents Error Code 



OPEN 
KB 

INTER 
FACE 



CA 



CA+1 



CA+2 



80H 



KB Input 

Command 

Word 

Max. 
Record 
Length 
Specifi- 
cation 
(up to 
240 bytes) 



See 82H, 08, 12, or 14 
below 

Other codes 
do not apply 



READ 

IN 

PROCESS 



Initiated 
by 64000 
program 
in response 
to 80H above 



CA 



82H 



64000 stores KB- 
input-command 
word & max. record 
length spec. It then 
monitors KB- 
output-command 
word until positive 
word is detected 
and then responds 
as follows: 



Initiated CA 00 
OUTPUT by 64000 

AVAILABLE after CA+1 KB out- put 

82H, above command 

word 
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Table 8-3. Keyboard I/O Interface Codes (Cont'd) 



Request 
Name 



64000 Response To: 
User Program Request Valid User Request invalid Request 



Address 



Contents Address 



Contents Error Code 



User pro- 
gram may 
then re- 
spond to 
00 with 
80H or 
81 H as 
shown 
below. 



CA+2 



CA+3 



Reserved 
for Lost 
Character 



Actual 
record 
length 
(#of KB 
bytes) 



CA+4 
1 

(CA+4) 
+n 



KB Byte 0 
i 

KB Byte n 



CLOSE CA 81 H CA 00 08 or 14 

KB 

I/O 

Other 
codes 
do not 
apply. 



See table 8-8 for complete error code listing. 
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Table 8-4. Command Word Codes 



Part A. KB • Input - Command Word 
Code Meaning 

-1 Current line not cleared. Characters appended to previously displayed 

characters. 

-2 Current line cleared. Previously displayed characters erased. 

Part B. KB - Output - Command Word 
Code Meaning 

8 Insert character in full line (lost character placed in CA+2 ) 

9 Tab Key 

10 Down arrow l<ey 

11 Up arrow key 

12 Display next page 

13 Carriage return 

14 Attempting to move cursor right past last allowed screen location 

15 Attempting to move cursor left past first allowed screen location 

16 Delete character from full line 

17 Shift key 

18 Display previous page 

19 Roll display down 

20 Roil display up 

21 Shift right arrow key 

22 Shift left arrow key 

23 Clear line key 

24 Actual record length exceeded record length specification (lost character 
placed in CA+2) 
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Phase I - User Requests Interface Opening 



LOCATION 


CONTENTS (From User Program! 


CA* 


80H (OPEN KB l/Oi 


CA+1 


KB INPUT COMMAND WORD 


CA+2 


MAX RECORD LENGTH 
SPECIFICATION (UP TO 2401 



KB I O BUFFER 



*The actual address for location "CA" is 
defined by the user during configuration 
of the emulation "CMDFILE". 



Phase II - 64000 Response to Open-Interface Request 



LOCATION 


CONTENTS (From 64000) 


CA 


82H (READ IN PROCESS! 



SEPARATE 
BUFFER SET UP 
BY 64000 



KB INPUT COMMAND WORD 



MAX RECORD LENGTH 
SPECIFICATION 



64000 BUFFER 



Figure 8-7. Keyboard I/O Interface Sequence 
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Phase III - 64000 Detects Positive KB Output Command Code 



ADDRESS 



CONTENTS 



CA 


0 KB OUTPUT AVAILABLE 


CA+1 


KB OUTPUT COMMAND WORD 


CA+2 


RESERVED FOR LOST 
CHARACTER 


CA+3 


ACTUAL RECORD LENGTH 
(# OF KEYBOARD BYTES) 


CA+4 


KB BYTE 0 


(CA+4) 
+n 


\ 

KB BYTE N 



SET BY 64000 PROGRAM 



KB OUTPUT 

COMMAND 

WORD- 



KEYBOARD 



'When word goes positive, 
the 64000 transfers data 
to I/O buffer. 



KB I/O BUFFER 



Phase IV - The user program may respond with either an 80H code as shown for phase I or an 
81 H code which closes the simulated keyboard I/O interface. 

Figure 8-7. Keyboard I/O Interface Sequence (Cont'd) 



Disc File I/O Interface 




The disc file simulated I/O control codes can be used to 
access critical system files. Extreme care should be used if 
any of the following types of files are accessed: 



Emulation Command Files (Type 6) 

Linl<er Command Files (Type 7) 

Linker Configuration Files (Type 8) 

Incorrectly accessing these files may destroy them and cause 
serious system problems! 
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The following paragraphs describe the type of files and the events which must be 
implemented between the user and the 64000 program to either: (1) create a new disc file, or 
(2) read from, write into, delete, or change the name of an existing file. The file types are 
described first. Then, the program events are described in the following order: 

a. Creating New File 

1) Creating File (80H) 

2) Writing First Record (89H) 

3) Writing Additional Records (89H) 

4) Closing Created File (82H) 

b. Accessing Existing File 

1) Opening File (81H) 

2) Selecting Record 

(a) Automatic selection of records 1, 2, 3, ... etc. 

(b) Advance "N" records (84H) 

(c) Backup "N" records (85H) 

(d) Position to record "N" (86H) 

(e) Rewind to record one (88H) 

3) Reading Record (87H) 

4) Writing Record (89H) 

5) Closing Open File (82H) 

c. Deleting File (83H) 

d. Changing File Name Associated with a OA (8AH) 
The predefined file types are listed in table 8-5. 
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Table 8-6 summarizes the user program requests, the corresponding control codes, and, 
where applicable, corresponding parameters. 

File Types 

The names and type numbers are listed in table 8-5. 

Creating New File 

Creating File. To create a new file, the user program places the file type number into location 
CA+1, the disc number into location CA+2, and then places code 80H into location CA. (The 
disc number is the disc upon which the file will reside.) 

NOTE 



CA represents the memory location to which all disc file I/O 
"handshaking" codes are sent by both the user program and 
the 64000 program. The actual address for the disc files CA is 
defined in the user program and entered into the 64000 during 
the configuration of the emulation CMDFILE. Each I/O 
interface - disc files, display, keyboard, etc. - requires its own 
unique CA address. 

Certain I/O codes sent to location CA must also include 
supplemental information. This supplemental information is 
contained in the locations following CA, i.e., CA+1 thru CA+n. 
The supplemental information must be placed into locations 
CA+1 thru CA+n BEFORE the corresponding control code is 
placed into CA. If this is not done, the 64000 may respond to 
the control code in CA before the supplemental data is set 
into locations CA+1 thru CA+n. 



The 64000 responds by creating the file type requested and returning a 00 to location CA 
which indicates the file has been created. 

If the file cannot be created, an error code as shown in table 8-6 is returned to location CA. 
(General definitions for the error codes are listed in table 8-8.) 

After the file is created, the user program may either write records immediately into it, or 
close it, and then reopen it and write records into it later. 

Writing First Record. After a file is created the first record is written into it as follows. The user 
program places parameters, as described below, into locations CA+1 thru CA+n, and then 
places code 89H into location CA. 
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The number of words in the write record is placed into location CA+1. A write record may 
contain up to a maximum of 128 words (256 bytes). Thus, an even number of bytes (whole 
words) must always be written. 



Locations CA+2 thru (CA+2)+n contain the words of the write record. 

The 64000 responds by automatically writing the records into the file as record number 1. 
After the record is successfully written, the 64000 returns a 00 to location CA. If the record 
cannot be written, an error code, as listed in table 8-6, is returned to location CA. 

Additional records are written into the file as described in the next paragraph. 

Writing Additional Records. If the newly created file is still open (i.e., has never been closed), 
additional records are written into the file as described for record one with the following 
difference. Each succeeding record is automatically written with the next corresponding 
record number. Thus, the second record written becomes record number 2, the third record 
written becomes record number 3, etc. 

Closing Created File. To close the newly created file, the user program places code 82H into 
location CA. The 64000 responds by closing the file and returning a 00 to location CA. If the 
file cannot be closed, an error code, as listed in table 8-6, is returned to location CA. 

Accessing Existing Files 

Opening File. To open an existing file, the user program places the file type number into 
location CA+1, the disc number into location CA+2, and then places code 81 H into location 
CA. 

The 64000 responds by opening the file and returning a 00 to location CA which indicates the 
file Is open. If the file cannot be opened, an error code, as shown in table 8-6, is returned to 
location CA. 




When a record is written into a file, it always becomes the last 
record in the file. Thus, writing a record into any location 
other than at the end of the file effectively erases all the 
following records in the file. When accomplishing the 
following paragraph choose record positions with care! 



After the file is opened, the user program may either: (1) immediately read/write* record 1, (2) 
select any record for reading, or (3) select a position within the file to begin writing*. 
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Selecting Record. Records are selected in any of the following ways: 

a. Automatic selection of records 1, 2, 3, .... etc. When the file is opened, record 1 is 
automatically selected. Thus, it may be immediately written into, or read from, without 
first selecting it with an "advance", "position", or "rewind" code. After reading or 
writing record 1, record 2 is automatically selected and may be read from, or written 
into. This process can be continued for records 3, 4, 5 etc. 

NOTE 



Remember, that when a record is written into a file, it becomes 
the end of the file. 



b. Advance "N" Records. Records located ahead of the currently selected record (i.e., 
those records with higher numbers) may be selected as follows. The user program 
places the number of records into locations CA+1 and CA+2, and then places code 
84H into location CA. The number of records is selected with a 15-bit word. The eight 
least significant bits are located in CA+1 . The seven most significant bits are located in 
CA+2. The most significant bit in CA+2 is not used. 

The 64000 responds by advancing the specified number and returning a 00 to location 
CA. If the record cannot be selected, an error code, as shown in table 8-6, is returned 
to location CA. 

After the record is selected, the user program may then either read from or write into it. 

c. Backup "N" Records. Records located behind the currently selected record (i.e., those 
records with smaller numbers then the current record) are selected in a way very 
similar to "advance "N" records". The only difference is that backup code 851-1 is 
placed into location CA. Locations CA+1 and CA+2 contain the number of records as 
defined in subparagraph b above. The 64000 also responds as described above. 

d. Position to Record "N". Any record within the file may also be selected without 
knowing its location relative to the current record. This method is also similar to the 
"advance" or "backup" methods. The difference is that position code 86H is placed 
into location CA. Location CA+1 and CA+2 contain the record number as defined in 
subparagraph b above. The 64000 responds as described above. 

e. Rewind to Record One. This is a fast way to select record 1. This method differs from 
the previous selection method in several ways. First, only record 1 can be selected 
using this method. Second, the user program places code 88H into location CA. Third, 
there are no entries required in locations CA+1 and CA+2. The. 64000 program 
responds as described in subparagraph b above. 
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Reading Record. Once a record has been selected by one of the methods described above, it 
may be read as follows. The user program places the maximum number of 16-bit words it will 
accept from the record into location CA+1. Up to 128 words may be accepted. (The 
recommended technique is always set CA+1 to 128. Then, after reading is complete, throw 
away those words not wanted, if any.) After specifying location CA+1, code 87H is placed 
into location CA. 

If the record is read successfully, the 64000 responds as follows: code 00 is returned to 
location CA. The actual number of 16-bit words read from the buffer is placed in location 
CA+1. Location CA+2 thru (CA+2)+n contains bytes 0 thru n. 

If the record cannot be read, an error code, as shown in table 8-6, is returned to location CA. 

Writing Record. A new record may be written into an existing file in either one of two ways. 
The record may be added to the end of the file or it may be written over an existing record in 
the file. However, if an existing record is written over, then the newly written record becomes 
the last record in the file. 

To add a record to the end of the file, the record selected must be one greater than the last 
record in the file. For example, if a file contains five records, then record 6 must be selected 
before writing is initiated. (If record 5 is selected, it will be written over by the new record.) 
After writing record 6, record 7 may be written by issuing another write code, etc. 

To write over an existing record, first select the record and then initiate writing. Again, 
remember that all following records in the file are erased. For example, if a file contains 10 
records, and record three is written over, then records four thru ten are erased. 

Closing Open File. An open file is closed in the same way as described for a newly created 
file. That is, the user program places code 82H into location CA. The 64000 responds by 
closing the file and returning a 00 to location CA. If the file cannot be closed, an error code, 
as listed in table 8-6, is returned to location CA. 

Deleting Files 

To delete a file, the user program places the file type into location CA+1 , the disc number into 
location CA+2, and then places code 83H into location CA. The 64000 responds by deleting 
the file. If the file cannot be deleted, an error code is returned to location CA as shown in 
table 8-6. This delete is similar to a "purge" command in the general operating system. The 
purged file does go into the recoverable file list. 

Changing File Name Assigned to a Particular CA 

The file name associated with a given CA location may be changed. This does not rename 
any files on the disc, but simply changes the name in the emulation command file associated 
with a given CA. To do this the user must first make sure that the present file associated with 
the CA of interest is closed. 
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To change the file name in the emulation configuration file, the user program places the new 
name record into locations CA+1 thru CA+16, and then places code 8AH into location CA. 
The name record is a fixed length record consisting of eight, 16-bit words. This record 
contains the record name, USERID, and specifies the length of both of these items. 

The name must contain at least one character and may be up to nine characters long. The ID 
may be up to six characters long. However, the name and ID lengths are specified in a unique 
way. Also, the words containing these characters must be packed in the name record. 
Specifying name and character lengths and packing the words are done in the same way as 
described for the "Microprocessor Configuration Record" in the Linker Symbols File 
description. This description is located toward the end of this chapter. 

To actually change the name of an existing file, the user must copy the contents of the file 
under the old file name into the file with the new file name. Either one or both of these files 
names may be specified by the user program at run time and accessed after "change file 
name" has been issued to the appropriate CA locations. 

Table 8-5. Disc File Type Numbers and Names* 



File Type Number File Name 

2 Source 

3 Relocatable 

4 Absolute 

5 Listing 

6 Emulation Command 

7 Linker Command 

8 Trace 
10 Data 

12 Assembler Symbols 

13 Linker Symbol 

**14 Types are defined and numbers assigned by 
thru user program. 

255 



* Formats for selected files are described at the end of this chapter. 

** HP may require some unassigned numbers for future use. It is, therefore, strongly 
recommended that the DATA (type 10) file be employed for the user defined type file. 

There are predefined types of files, identified by numbers 2 thru 13, that may be created by 
the user program. 
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File type numbers 14 thru 255 may be assigned to files defined by the user program, as 
required. It should be noted, however, that HP may require some unassigned numbers for 
future use. It is, therefore, recommended that the user leave space for this possibility, starting 
with number 14. 

NOTE 



Once created, file types 14 thru 255 can only be deleted by 
using the simulated I/O delete command. 



The overall file name is assigned during emulation configuration. Under any one file name, 
only one each of a file type may be created. For example, a file named USA may only have 
one each of file types 2 thru 255. It cannot have two type 3 files. 




The disc file simulated I/O codes can be used to access 
critical system files. Extreme care should be used if any of the 
following types of files are accessed: 



Emulation Command Files (Type 6) 

Linker Command Files (Type 7) 

Linker Configuration Files (Type 8) 

Incorrectly accessing these files may destroy them and cause 
serious system problems! 
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Table 8-6. Disc File I/O Codes 



Request 
Name 



CREATE 
FILE 



Address 

CA 

CA+1 



User Program 64000 Response To: 

Request 

Valid User Request Invalid Request 
Contents Address Contents Error Code 



80H 



File Type 
Number 



CA 



00 



01 thru 08, 10 



09: file is 
not open 



CA+2 



Disc # 



11 thru 14: NA 



OPEN 
FILE 



CA 



81 H 



CA 



00 



01 thru 08, 10 



CA+1 



File Type 
Number 



09: File is 
already 
open 



CA+2 



Disc # 



11 thru 14: NA 



CLOSE CA 82H CA 00 01 thru 08 

FILE 

09: File is 
already 
closed 

10 thru 14: NA 



DELETE 
FILE 



CA 



83H 



CA 



00 



01 thru 08,10 



CA+1 



File Type 
Number 



09: File not 
open 
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Table 8-6. Disc File I/O Codes (Cont'd) 



Request 
Name 



ADVANCE 

"N" 
RECORDS 



User Program 
Request 



64000 Response To: 



Address 

CA+2 
CA 
CA+1 
CA+2 



Contents 

Disc # 
84H 

LSB 15-bit* 
record 
IVISB number 
(*bit 16 not 
used) 



Valid User Request 
Address Contents 



CA 



00 



Invalid Request 
Error Code 

11 tiiru 14: NA 

01 thru 08 

09: File not 
open 

10 tliru 14: NA 



BACKUP 

"N" 
RECORDS 



CA 

CA+1 

CA+2 



85H 

LSB 15-bit* 
record 
MSB number 
(*bit 16 not 
used) 



CA 



00 



01 thru 08 

09: File not 
open. 

10 thru 14: NA 



POSITION 

TO 
RECORD 

"N" 



CA 

CA+1 

CA+2 



86H 

LSB 15-bit* 
record 
MSB number 
(*bit 16 not 
used) 



CA 



00 



01 thru 08 

09: File not 
open 

10 thru 14: NA 



READ 
RECORD 



CA 



87H 



CA 



00 



01 thru 08 



CA+1 



Max. 
number 
of words 
user can 
accept. 
(128 words/ 
256 bytes max.) 



CA+1 



Actual # 
of words 
read 
from 
buffer. 



09: File is 
not open 

12 
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Table 8-6. Disc File I/O Codes (Cont'd) 



Request 
Name 



User Program 
Request 



Address 



Contents 



64000 Response To: 



Valid User Request Invalid Request 



Address 

CA+2 
i 

(CA+2) 
+n 



Contents Error Code 

Read 

Byte 1 10, 11, 13, 14: NA 
i 

Read 
Byte 



(*256 bytes/ 
128 words 
is max. 
record 
length.) 



REWIND 
TO 

RECORD 
ONE 



CA 



88H 



CA 



00 



WRITE 
RECORD 



CA 



CA+1 



89H 



Number of 
words to be 
written. 
(128 words/ 
256 bytes 
maximum.) 



CA 



00 



01 thru 08 

09: File is 
not open 

10 thru 14: NA 

01 thru 08, 12 



09: file is 
not open. 

10, 11, 13,14: NA 



CA+2 
1 

(CA+2) 
+n 



Write byte 1 
1 

Write byte n 
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Table 8-6. Disc File I/O Codes (Cont'd) 



Request User Program 

Name Request 

Address Contents 

CHANGE CA 8AH 

FILE 

NAME 



64000 Response To: 

Valid User Request Invalid Request 
Address Contents Error Code 

CA 00 01 thru 08 

12 & 15 



SEE 

NOTE 

BELOW 



Bits 7-5 
specify 
length of 
file name 
in 16-bit 
words-1. 
Bits 4 & 3 
specify 
ID length 
in 16-bit 
words. 
Bits 2-0 
contain 
all zeros. 
(See note 
below.) 



09: File 
not open 



10, 11, 13, 
14: NA 



CA+2 



First 

character 
of file 
name. 
Limited to 
capital 
letters 
A thru Z. 



CA+3 



Second 
and 

following 
file name 
characters 
may be 
small or 
capital 
letters, 
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Table 8-6. Disc File I/O Codes (Cont'd) 



User Program 64000 Response To: 

Request 

Valid User Request Invalid Request 
Address Contents Address Contents Error Code 

numerals 
0 thru 9, 
underlines, 
and 
only if 
required 
one blank 
nnay be used 
to fill in 
last character 
in last word 
of name. 

CA+4 Up to 9 

thru name 

CA+n. characters 

Where may be used, 
n 10 

CA+ First USERID 

(n+1) character. 

CA+ Up to 6 

(n+2) USERID 

i characters 
thru may be used. 

1 

CA+16 See note 

below. 

Note; The name and USERID characters must be packed into a fixed length record. This 
record consists of 8, 16-bit words. Thus, the name record will always require a user buffer 
consisting of 17 bytes (byte CA through byte CA+16). All unused 16-bit words must be at the 
end of the record. No intervening unused words or bytes are allowed. If the last byte in the 
last name and ID word is not required to define the name, then it must contain an ASCII 
blank. The byte in buffer location CA+1 must be formatted the same as described for the 
most significant byte of word 16 in the name and user ID word block of the microprocessor 
configuration record. Refer to the "Microprocessor Configuration Record" in the Linker 
Symbols description for more information. 



Request 
Name 
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RS-232 I/O Interface 

The following paragraphs describe the events which must be implemented between the user 
and the 64000 programs for RS-232 I/O to occur. 

These events are: 

• Open RS-232 File 

• Initialize 8251 

• Command To 8251 

• Status From 8251 

• Write To 8251 

Write Single Byte 
Write Record 

• Read From 8251 

Read Single Byte 
Read Record 

• Updating Read/Write Buffers 

The above events, corresponding control codes, and parameters, where applicable, are 
summarized in table 8-7. 

Open RS-232 File (80H) 

Before any other RS-232 operation can be initiated, the user program must request that the 
RS-232 File be opened. This is done by placing code 80H into location CA. 
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NOTE 



CA represents the location to which all RS-232 I/O 
"handshaking" codes are sent by both the user and the 64000 
programs. The actual address for the RS-232 CA is defined in 
the users program and entered into the 64000 program during 
the configuration of the emulation CMDFILE. Each I/O 
interface - RS-232, display, printer, etc.- requires its own 
unique CA address. 

Certain of the I/O codes sent to location CA must also include 
supplemental information. This supplemental information is 
contained in the locations following CA, i.e., CA+1 thru CA+n. 
The supplemental information must be placed into locations 
CA+1 thru CA+n BEFORE the corresponding control code is 
placed in CA. If this is not done, the 64000 may respond to the 
control code in CA before the supplemental data is set into 
locations Ca+1 thru CA+n. 



The 64000 responds by opening the RS-232 file and returning a 00 to location CAto indicate 
that the file is open. If the file cannot be opened, error code 08 or 09 is returned to location 
CA. 

After the file is opened, the 8251 must be initialized as described in the next paragraph. 

Initialize 8251 (82H) 

In general, 8251 initialization consists of resetting the 8251 and then selecting one of the 
following three operating modes: (1) asynchronous, (2) synchronous with one sync 
character, or (3) synchronous with two sync characters. (See figure 8-8.) 

For each of the three modes, the user program requests initialization by first setting up buffer 
locations CA+1 thru CA+5 and then placing code 82H into location CA. A command 
instruction with Internal Reset (IR) bit D6 set is placed into location CA+1. (See figure 8-9.) 
The contents placed into locations CA+2 thru CA+5 depend upon the. operating mode 
selected as described in the following paragraphs. 

Asynchronous Mode - For this mode, the asynchronous mode instruction is placed into 
location CA+2 and a sync option word specifying 0 must be placed into location CA+3. 
Locations CA+4 and CA+5 contain no meaningful data. 
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The asynchronous mode instruction is used to select the baud rate*, the character length, 
the parity parameters, and the number of stop bits. (See figure 8-10.) (*The only baud rates 
which may be used with the 64000 are the transmitter clock frequency (1 X Txc) or 1/16 X Txc. 
The baud rate factor of 1/64 X Txc cannot be used with the 64000. The basic frequency of Txc 
is selected by switches on the modem I/O card. Thus, the basic frequency (Txc) may be 
changed by the I/O card switches.) The user must format this instruction so that the 
appropriate parameters are specified. 1/16 X Txc must be programmed if the baud rate is to 
match the baud rate table in the System Overview manual. 

The sync option specifies 0 since there are no sync characters for the asynchronous mode. 

Synchronous Mode/Single Sync Character - For this mode, the synchronous mode 
instruction is placed into location CA+2, the sync option word specifying "1" is placed into 
location CA+3, and the sync character is placed into location CA+4. Location CA+5 contains 
no meaningful data. (See figure 8-8.) 

The synchronous mode instruction is used to select the character length, and the parity and 
synchronization parameters. (See figure 8-1 1 .) Bit D7 (SOS) of this word must specify a single 
sync character.The user must format this instruction so that the other appropriate 
parameters are specified. 

The sync option word specifies "1" for a single sync character. 
The format of the sync character must be defined by the user. 

Synchronous Mode/Double Sync Character - For this mode, the synchronous mode 
instruction is placed into location CA+2, the sync option word specifying "2" is placed into 
location CA+3 and sync characters 1 and 2 are placed into locations CA+4 and CA+5, 
respectively. (See figure 8-8.) 

The synchronous mode instruction is used to select the character length, and the parity and 
synchronization parameters. (See figure 8-11.) Bit D7 (SCS) of this word must specify a 
double sync character. The user must format this instruction so that the other appropriate 
parameters are specified. 

The sync option word specifies "2" for double sync characters. 
The format of both sync characters must be defined by the user. 

After the 8251 is initialized, the 64000 returns a 00 to location CA. If the 8251 cannot be 
initialized, error code 08 or 09 is returned as shown in table 8-7. 
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Command to 8251 (83H) 

After the 8251 is initialized (i.e., reset and asynclironous or synchronous operation selected), 
it must be placed in the appropriate mode - transmit, receive, or combination 
transmit/receive, etc. To do this, the user program first places the appropriately formatted 
command word into location CA+1 and then places code 83H into location CA. (The user 
must format the command word to select the applicable operation as shown in figure 8-9.) 

The 64000 responds by supplying the command word to the 8251 and returning a 00 to 
location CA. If this cannot be done, code 08 or 09 is returned to location CA. (See table 8-7.) 

Status From 8251 (84H) 

The user may check the status of the 8251 at any time. To do this, code 84H is placed into 
location CA. The 64000 responds to this status request by returning a 00 to location CA and 
placing the 8251 status word in location CA+1. 

The status word format is shown in figure 8-12. 

The status bits DO, D1 , and D2 may be cleared or set by the 64000 program when operating in 
any of the buffered modes. If the user desires these bits to control operation, it is necessary 
to close the appropriate Tx or Rx buffers first. 

Write To 8251 

The user program may write to the 8251 in either of two ways. It may write a byte at a time, or a 
write buffer may set up and data writen continuously. Both methods are described. (Note: 
Before attempting to write data, the 8251 must be initialized and the command word, in the 
appropriate format, sent to the 8251 as described in the previous paragraphs.) 

Write Single Byte (86H) - To write a single byte to the 8251, the user program first places the 
write byte into location CA+1 and then places code 86H into location CA. (See table 8-7.) The 
64000 responds by supplying the byte to the 8251 and returning a 00 to location CA. If writing 
cannot be done, error code 08 or 09 is returned to CA. (See table 8-7.) If more data is to be sent, 
it is recommended that the user poll the 8251 status to determine if the 8251 is ready to receive 
more transmit data. 

Write Record (87H), Update Write Buffer (89H) (See also Update Read/Write Buffer (8DH))- To 
write a record to the 8251, the user program must first set up a write buffer and identify the 
beginning and ending locations in the buffer. (The corresponding 64000 write buffer holds a 
maximum of 256 bytes.) (See figure 8-13.) It then writes a record into the buffer and identifies 
the buffer locations into which the first and last bytes of the record are written. 

The user program must then request that the record be transferred to the 8251. (See figure 8- 
14.) This is done by first placing the user write buffers beginning/ending and first/last byte 
address pointers into locations CA+7 thru CA+22 and then placing code 87H into location CA. 
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The 64000 responds by transferring data from the users write buffer into a 64000 write buffer. 
(See figure 8-15.) For each byte transferred to the 64000 buffer, the first byte address pointer (in 
locations CA+15 thru CA+18) is incremented by one. Data transfer continues until either all 
data in the users write buffer is transferred or the 64000 write buffer becomes full. (The 64000 
write buffer holds a maximum of 256 bytes, or 128 words.) After a write buffer is set up and if 
update code SDH or 89H is used, then the number of bytes actually transmitted by the 8251 is 
also entered into location CA+6 by the 64000 program. The number of bytes transmitted refers 
to the number of bytes transmitted from the 64000 buffer. 

The user program should periodically examine the first and last address byte pointers (and if 
using update code 8DH or 89H, the number of bytes transmitted by the 8251 may also be 
examined) to determine the status of the buffer. (If the first and last byte pointers are equal, all 
data was transferred to the 64000 buffer.) 

If all data was transferred, the user program may either supply another write record, or close 
the write buffer. If all data was not transferred, the user program may either wait until the 
remaining data is transferred, add more data to the buffer and update the last byte pointer, or 
close the write buffer. Each of these options is described in the following paragraphs. 

Additional data may be added to, or a new record written into the buffer and the last byte 
address pointer updated as follows: If the first and last byte address pointers are pointing to the 
same location, the first new byte goes into the location pointed to by both pointers. If the first 
and last byte address pointers are not pointing to the same location, then the first new byte 
goes into the location just ahead of the one pointed to by the last byte address pointer (i.e., last 
byte address pointer + 1 ). Then the following bytes are entered into succeeding locations. (See 
figure 8-15.) 

After entering data into the buffer.the user program requests write data transfer. This is done 
by first placing the updated last byte address pointer into locations CA+IQthru CA+22and 
then placing code 89H into location CA. (See figure 8-16.) 

The 64000 responds by transferring data from the users write buffer to the 64000 write buffer, 
increments the first byte address pointer for each byte transferred, and if update code 8DH or 
89H is being used, the number of bytes sent by the 8251 is also updated. 

Once the user program has placed code SDH or 89H (update buffer) into location CA, the 64000 
routinely monitors the last byte address pointer to determine if more data has been loaded into 
the users write buffer. If the 64000 detects that the last byte address pointer has been 
incremented, it transfers the data and increments the first byte address pointer to indicate the 
number of bytes written. It also updates the number of bytes sent by the 8251. 

To write another record, the user program updates the last address pointer. The 64000 
responds as described above. 
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To close the buffer, the user program places code 88H in location CA. The 64000 closes the 
write buffer and returns a 00 to location CA. 

Data may be stored in the users write buffer using a "wrap around" method. That is, once the 
last location in the buffer is filled, the next byte is placed into the first location of the buffer. 
Thus, it is possible for the last byte address pointer to be pointing to an address that is less than 
(i.e., ahead of) the first byte address. 

If any of the write buffer requests cannot be done, the 64000 returns the appropriate error code 
to location CA as shown in table 8-7. 

Read From 8251 

Reading data from the 8251 is similar to writing data to the 8251. The user program may read 
data in either of two ways. It may read a byte at a time or it may set up a read buffer and read a 
record at a time. Both methods are described. Note: Before attempting to read data, the 8251 
must have been initialized and the command word, in the applicable format, sent to the 8251 as 
described in the previous paragraphs. 

Read Single Byte (85H) - To read a single byte from the 8251 , the user program places code 85H 
into location CA. (See table 8-7.) 

The 64000 responds by returning a 00 to location CA and the read byte to location CA+1. If 
reading cannot be done, error code 08 or 09 is returned to CA. 

The 64000 will return whatever character is in the Rx buffer of the 8251. It is recommended that 
the user check the status of the 8251 to see if Rx RDY is true before performing the single byte 
read. Any read operation will clear Rx RDY, indicating thatthe character in the buffer has been 
read. 

Read Record (8AH), Update Read Buffer (8CH) (see also Update Read/Write Buffer (8DH)) - To 
read a record from the 8251, the user program must first set up a read buffer and identify the 
beginning and ending locations in the buffer. (See figure 8-17.) 

This is done by first placing the address pointers into locations CA+24 thru CA+39 and then 
placing code 8AH into location CA. Locations CA+24 thru CA+31 contain the address pointers 
for the beginning and ending locations of the users read buffer. 

Locations CA+32 thru CA+39 contain the address pointers for the first and last bytes written 
into the buffer. These pointers are both initially set to point to the first location in the users read 
buffer. This indicates that the buffer is empty. (The 64000 will force the first data pointer to 
always point to the beginning of the buffer.) 
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The 64000 responds by continuously transferring read data from the 8251 to the 64000 read 
buffer. (See figure 8-19.) The user program must then issue an 8CH or SDH to transfer the data 
to the users buffer. For each byte transferred into the users read buffer, the last byte address 
pointer is incremented by one (see figure 8-18). In addition, when update code 8DH or 8CH is 
being used, the number of bytes received by the 8251 and transferred into the 64000 is entered 
into location CA+23. 

To determine when and how much read data is available, the user program must monitor the 
last byte address pointer and the number of bytes received. When read data is found in the 
buffer, the user program should process the data. If all data expected was received, the user 
program may then close the read buffer. 

Once the user program has placed code 8CH or SDH into location CA, the 64000 periodically 
monitors the output of the 8251, transfers data into the user read buffer, and updates the last 
byte address as required. The user program in turn monitors the last byte address pointer to 
determine if more data is available. This process continues until the user program closes the 
read buffer. 

If code 8CH or SDH is being used, and the user issues an 8AH again, the buffer is frozen for the 
user, yet the 64000 continues to receive data into its buffer. 

To close the read buffer, the user program places code 8BH into location CA. The 64000 closes 
the buffer and returns a 00 to location CA. 

Data may be stored in the user's read buffer using a "wrap around" method. That is, once the 
last location in the buffer is filled, the next byte is placed into the first location of the buffer. 
Thus, it is possible for the last byte address pointer to be pointing to an address that is less than 
(i.e., ahead of) the first byte address. 

If any of the read buffer requests cannot be done, the 64000 returns the appropriate error code 
to location CA as shown in table 8-7. 

Updating Read/Write Buffers (SDH) 

Once the read and write buffers have been set up and opened as described in preceding 
paragraphs "Write to 8251" and "Read from 8251", the buffers may both be updated by using 
one code. To do this, the user program places the updated first and last byte address pointers 
for both the read and write buffers into the corresponding locations in the RS-232 I/O control 
buffer and then places code SDH into location CA. 

The 64000 responds to the update request as described in the "Write to 8251" and "Read from 
8251" paragraphs. However, in addition to setting, monitoring, and updating the first and last 
byte address pointers, the number of bytes received and transmitted by the 8251 is also set, 
updated, and monitored. This provides an additional indication of how much data has been 
sent and received. 
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Table 8-7. RS-232 I/O Codes 



Request 
Name 



User Program 
Request 



64000 Response To: 
Valid User Request Invalid Request 



Address 



Contents 



Address 



Contents Error Code 



OPEN 

RS-232 

FILE 



CA 



80H 



CA 



00 



01-07: NA 
08 

09: File already 
open. 

10-14: NA 



CLOSE 
RS-232 
FILE 



CA 



81 H 



CA 



00 



01-07: NA 
08 

09: File not 
open. 

10-14: NA 



INITI- 
ALIZE 
8251 



CA 



CA+1 



CA+2 



CA+3 



CA+4 



CA+5 



82 H 



Command 
Instruction 

Mode In- 
struction 

Sync Op- 
tion word 

Sync Char- 
acter.one 

Sync Char- 
acter.two 



CA 



00 



Same as 81 H, 
above 
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Table 8-7. RS-232 I/O Codes (Cont'd) 



Request 
Name 



User Program 
Request 



64000 Response To: 



Address 



Valid User Request Invalid Request 
Contents Address Contents Error Code 



COMMAND 

TO 

8251 



OA 
CA+1 



83H 

Command 
Word 



OA 



00 



Same as 81 H, 
above 



STATUS 

FROM 

8251 



CA 



84H 



CA 
CA+1 



00 

Status 
Word 



Same as 81 H, 
above 



READ 

SINGLE 

BYTE 

FROM 

8251 



CA 



85H 



CA 
CA+1 



00 

Byte 
Read 



Same as 81 H, 
above 



WRITE 

SINGLE 

BYTE 

TO 

8251 



CA 
CA+1 



86H 

Write 
Byte 



CA 



00 



Same as 81 H, 
above 



OPEN 

WRITE 

BUFFER 



CA 
CA+1 

I 

CA+5 



87H 

Reserved 
for Ini- 
tialization 
buffer 



CA 



87H 



The 64000 trans- 
fers write data 
from the users 
buffer to the 
64000 buffer. 
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Table 8-7. RS-232 I/O Codes (Cont'd) 



Request 
Name 



User Program 
Request 



Address 



CA+6 



CA+7 
(Isw, msb) 

CA+8 
(Isw, Isb) 

CA+9 

(msw, msb) 



Contents 

#Bytes 
sent by 
8251. 
Cleared 
by open 
(87H). 

Updated by 
64000 when 
update code 
89H or SDH 
is used. 
Buffer 
Begin 
Address 
pointer 



64000 Response To: 

Valid User Request Invalid Request 
Address Contents Error Code 

For each byte 
transferred 
to the 64000 
buffer, first 
byte address 
pointer is 
incremented by 
one. 



CA+10 
(msw, Isb) 

CA+11 Buffer 
(Isw, msb) End 

Address 
CA+12 pointer 
(Isw, Isb) 

CA+13 
(msw, msb) 

CA+14 
(msw, Isb) 
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Table 8-7. RS-232 I/O Codes (Cont'd) 



Request User Program 64000 Response to: 

Name Request 

Valid User Request Invalid Request 
Address Contents Address Contents Error Code 



CA+15 First 
(Isw, msb) Byte 

Address 
CA+16 pointer 
(Isw, Isb) 

CA+17 
(msw, msb) 

CA+18 
(msw, Isb) 

CA+19 Last 
(Isw, msb) Byte 

Address 
CA+20 pointer 
(Isw, Isb) 

CA+21 
(msw, msb) 

CA+22 
(msw, Isb) 
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Table 8-7. RS-232 I/O Codes (Cont'd) 



Request 
Name 



User Program 
Request 



Address 



Contents 



64000 Response To: 

Valid User Request Invalid Request 
Address Contents Error Code 



CLOSE 
WRITE 
BUFFER 



CA 



88H 



CA 



00 



Same as 
81 H, above. 



UPDATE CA 
WRITE 

BUFFER CA+1 



CA+5 
CA+6 



CA+7 
I 

CA+1 4 

CA+1 5 
(Isw, msb) 

CA+1 6 
(Isw, Isb) 



89H 

Reserved 
for Ini- 
tialization 
Buffer 

# Bytes sent 
by 8251. 

Not changed 
by user. 



First 
Byte 
Address 
pointer 



CA 



89H 



Same as 
81 H, above. 



The user up- 
dates the last 
byte address 
Pointer to 
indicate how 
much new write 
data is in the 
buffer. The 
64000 processes 
the write data, 
increments the 
first byte addr. 
pointer, and 
updates # bytes 
sent by 8251 
as required. 



CA+1 7 
(msw, msb) 

CA+1 8 
(msw, Isb) 



CA+1 9 
(Isw, msb) 

CA+20 
(Isw, Isb) 



Updated 

Last 

Byte 

Address 

pointer 
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Table 8-7. RS-232 I/O Codes (Cont'd) 



64000 Response to: 

Valid User Request Invalid Request 
Address Contents Error Code 

CA+21 
(msw, msb) 

CA+22 
(msw, Isb) 



Request User Program 

Name Request 

Address Contents 
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Table 8-7. RS-232 I/O Codes (Cont'd) 



Request User Program 64000 Response To: 

Name Request 

Valid User Request Invalid Request 
Address Contents Address Contents Error Code 



OPEN 
READ 
BUFFER 



CA 
CA+1 

\ 

CA+22 
CA+23 



CA+24 
(Isw, msb) 

CA+25 
(Isw, Isb) 



8AH 

Reserved for 
Initialization 
and write 
buffers. 
# Bytes 
received by 
8251. Cleared 
by open 
(8AH). 
Updated 
by 64000 
when update 
code 8CH or 
SDH is used. 
Buffer 
Begin 
Address 
pointer 



CA 



8AH 



Same as 
81 H, above 



The user sets 
first and last 
address pointers 
to point to buf- 
fer beginning 
address. The 
64000 will 
transfer data 
from the 8251 
to the 64000 
buffer. 
The user 
must use the 
commands 8CH 
or 8DH to 
transfer the data 
to the users 
buffer. 



CA+26 
(msw, msb) 

CA+27 
(msw, Isb) 

CA+28 Buffer 
(Isw, msb) End 

Address 
CA+29 pointer 
(Isw, Isb) 
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Table 8-7. RS-232 I/O Codes (Cont'd) 



Request User Program 64000 Response to: 

Name Request 

Valid User Request Invalid Request 
Address Contents Address Contents Error Code 



CA+30 
(msw, msb) 

CA+31 
(msw, Isb) 

CA+32 First 
(Isw, msb) Byte 

Address 
CA+33 pointer 
(Isw, Isb) 

CA+34 
(msw, msb) 

CA+35 
(msw, Isb) 

CA+36 Last 
(Isw, msb) Byte 

Address 
CA+37 pointer 
(Isw, Isb) 

CA+38 
(msw, msb) 

CA+39 
(msw, Isb) 
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Table 8-7. RS-232 I/O Codes (Cont'd) 



Request 
Name 



User Program 
Request 



Address 



CA 



CLOSE 

READ 

BUFFER 



UPDATE CA 
READ 

BUFFER CA+1 



CA+22 



CA+23 



CA+24 



CA+31 

CA+32 
(Isw, msb) 

CA+33 
(Isw, Isb) 

CA+34 
(msw, msb) 

CA+35 
(msw, Isb) 



Contents 

8BH 

8CH 

Reserved for 
Initializa- 
tion and 
write 
buffers. 

#Bytes 
received by 
8251. 

Not changed 
by user. 



First 
Byte 
Address 
pointer 



64000 Response To: 
Valid User Request Invalid Request 



Address 

CA 

CA 



Contents Error Code 



00 



80H 



The 64000 con- 
tinues to trans- 
fer data,incre- 
ments last byte 
address pointer, 
(updates #Bytes 
received by 
8251) 

as required. 
User program 
monitors these 
parameters to 
determine how 
much data is 
received. (64000 
forces first 
byte address 
pointer to 
always point 
to the begin- 
ning of the 
buffers.) 



Same as 
81 H 
above 

Same as 
81 H 



8-52 EMULATOR/ANALYZER 6809/6809E 



Table 8-7. RS-232 I/O Codes (Cont'd) 



Request User Program 64000 Response to: 

Name Request 

Valid User Request Invalid Request 
Address Contents Address Contents Error Code 



CA+36 Last 
(Isw, msb) Byte 

Address 
CA+37 pointer 
(Isw, Isb) 

CA+38 
(msw, msb) 

CA+39 
(msw, Isb) 



EMULATOR/ANALYZER 6809/6809E 8-53 



Table 8-7. RS-232 I/O Codes (Cont'd) 



Request 
Name 



User Program 
Request 



Address 



Contents 



64000 Response To: 

Valid User Request Invalid Request 
Address Contents Error Code 



UPDATE 
WRITE/ 
READ 
BUFFERS 



CA 
CA+1 

I 

CA+5 



CA+6 



CA+22 
CA+23 



CA+39 



SDH 

Reserved for 
Initialization 
Buffer 



Same as 

shown for 

update 

Write 

Buffer, 

above. 

Same as 

shown for 

update 

Read 

Buffer, 

above. 



CA 



OOH 



Same as 81 H 
above 



Write and read 
buffers are 
both updated 
as described 
above. 
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ASYNCHRONOUS SYNCHRONOUS MODE- SYNCHRONOUS MODE - 

MODE - INITIALIZATION SINGLE SYNC CHARACTER DOUBLE SYNC CHARACTER 

FORMAT INITIALIZATION FORMAT INITIALIZATION FORMAT 



CA 


82H - INITIALIZE 8251 




R2H - INITIAI IZF RP'^I 




82H - INITIALIZE 8251 


CA 


CA+1 


COMMAND INSTRUCTION 
(Internal neset o^oi^ 




COMMAND INSTRUCTION 
Untornai nesei odoi) 




COMMAND INSTRUCTION 
viniernai nesei o^oi) 


CA+1 


CA+2 


ASYNCHRONOUS 
MODE INSTRUCTION 




SYNCHRONOUS 
MODE INSTRUCTION 




SYNCHRONOUS 
MODE INSTRUCTION 


CA+2 


CA+3 


SYNC OPTION WORD 
0=No sync characters 




SYNC OPTION WORD 
1=1 sync character 




SYNC OPTION WORD 
2=2 sync characters 


CA+3 


CA+4 


Not Used 




SYNC CHARACTER 1 




SYNC CHARACTER 1 


CA+4 


CA+5 


Not Used 




Not Used 




SYNC CHARACTER 2 


CA+5 


CA+6 

1 

CA+22 


RESERVED FOR 
WRITE CONTROL 




RESERVED FOR 
WRITE CONTROL 




RESERVED FOR 
WRITE CONTROL 


CA+6 

1 

CA+22 


CA+23 

1 

CA+39 


RESERVED FOR 
READ CONTROL 




RESERVED FOR 
READ CONTROL 




RESERVED FOR 
READ CONTROL 


CA+23 

1 

CA+39 



Figure 8-8. 8251 Initialization Formats 
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D7 



EH 



De 



Ds 



D4 



ER 



D3 



D2 



Di 



Do 



TxEn 



Transmit Enable/Disable 
1=Enables normal operation 
at Transmit Data (TxD) 

output pin providing 

clear To Send Not (CTS) 
input pin Is low. 
0=Disables TxD output pin 
after all data in 8251 
Is sent. 



1= Force s Data Terminal Ready Not 
—J (DTR) pin to zero. (Normally used 
for modem control.) 



Receiver Enable/Disable 
1=Enables normal receiver operation. 
0=Holds receiver ready (RxRDY) 
output line in reset state. 



Send Break Character 
1=Forces Transmit Data (TxD) 
0=Allows normal transmit data output. 



Error Reset 

1=Resets: Parity (PE), Overrun (OE), and Framing (FE) 
error flags. 



Request To Send 
1=Forces RTS output pin to zero. (Normally used 
for modem control.) 



Internal Reset 

1=Places 8251 in "Idle" mode. Stays in "Idle" until 
Initialized by mode Instruction. 



Enter Hunt Mode 

1-Enables search for Sync Characters. Has no affect In Async mode. 



Figure 6-9. Cominand Mode Instruction Format 
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Dy De 



D5 



D4 D3 



D2 



Di Do 



S2 



Si 



EP 



PEN 



L2 



B2 



Bi 



S2 


s, 


0 


0 


0 


1 


1 

1 


0 

1 



NUMBER OF 
STOP BITS 

INVALID CODE 
1 BIT 

1 1/2 BITS 

2 BITS 



BAUD RATE 



1 X TXc- = 



1/16 X TXc' = 1 



NOT ALLOWED WITH 64000 = 1 



B2 


Br 


0 


0 


0 


1 


1 


0 


1 


1 



*TXc = TRANSMITTER CLOCK FREQUENCY 



CHARACTER 



LENGTH 


L2 


Li 


5 BITS = 


0 


0 


6 BITS = 


0 


1 


7 BITS = 


1 


0 


8 BITS = 


1 


1 



PARITY ENABLED = 1 
PARITY DISABLED = 0 



EVEN PARITY = 1 
ODD PARITY = 0 



Figure 8-10. Asynchronous Mode Instruction Format 
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D7 



De 



D5 



D4 



D3 



D2 



Di 



Do 



INDICATES SYNCHRONOUS 
MODE INSTRUCTION 



. CHARACTER LENGTH 
5 BITS 


L2 


Li 


= 0 


0 


6 BITS 


= 0 


1 


7 BITS 


= 1 


0 


8 BITS 


= 1 


1 




PARITY ENABLED = 1 
PARITY DISABLED = 0 



EVEN PARITY = 1 
ODD PARITY = 0 



EXTERNAL SYNC DETECT 
1=SYNC DETECT IS AN INPUT 
0=SYNC DETECT IS AN OUTPUT 



SINGLE CHARACTER SYNC 
1=SINGLE SYNC CHARACTER 
0=DOUBLE SYNC CHARACTER 



Figure 8-11. Synchronous Mode Instruction Format 
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D7 



DSR 



De 



SYN 
DET 



D5 



D4 



OE 



D3 



PE 



D2 



Tx 

EMPTY 



Di 



Rx 
RDY 



Do 



Tx 

RDY 



Logic 1 = 8251 ready to 
accept a write character 
for transmission. 



Logic 1 = 8251 contains a 
received character ready for 
reading. 



Logic 1 = Previous character has 
been transmitted - 8251 A has 
no characters to transmit. 



Logic 1 = Parity error. Does not inhibit 
8251 operation. Reset by ER Bit of 
Command Mode Instruction. 



Logic 1 = Overrun Error. Incoming character overran 
another character before it was read. Does 
not inhibit 8251 operation. Reset by ER bit in 
Command IVIode Instruction. 



Logic 1 = Framing Error. (Asynchronous mode only). Set 
when a valid stop bit is not detected. Does not 
inhibit 8251 operation. Reset by ER bit in 
Command Mode Instruction. 



Synchronous mode - 

High =Sync character detected In Internal sync mode. 
Start assembling characters In external sync mode. 
Async mode (Break Detect) 

High =Rx Data remained low during two consecutive stop bit sequences. 



Data Set Ready - Logic 1 Indicates DSR Input Is low. 



Figure 8-12. 8251 Status Word Format 
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Phase I - User Sets Up Write Buffer 

User sets up write buffer as follows: 

1. Assigns buffer beginning and ending addresses: WBUFBEG and WBUFEND. 

2. Writes block of characters into buffer shown as first byte through last byte. 



ADDRESS 


CONTENTS 


WBUFBEG 


FIRST BYTE 








LAST BYTE 




WBUFEND 



USERS WRITE 
BUFFER 



'The actual address for 
location "CA" is defined 
by ttie user during 
configuration of the 
emulation "CMDFILE". 



ADDRESS 



CONTENTS 



CA- 



CA+1 



BUFFER RESERVED 
FOR RS-232 I/O 
PARAMETERS SENT 
WITH CONTROL 
CODES 



CA+23 



RS-232 I/O CONTROL BUFFER 



Figure 8-13. Writing RS-232 Record - Phase I 
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ADDRESS CONTENTS 



WBUFBEG 


FIRST BYTE 








LAST BYTE 




WBUFEND 



USER'S WRITE BUFFER 



ADDRESS 


CONTENTS (FROM USER PROG) 


CA 


87H (OPEN WRITE BUFFER) 


CA+1 
♦ 

CA+5 


RESERVED FOR 8251 
INITIALIZATION BUFFER 


CA+6 


# BYTES TRANSMITTED BY 
8251 SINCE BUFFER OPENED 


CA+7 
CA+8 
CA+9 
CA+10 


Isw.msb 

Isb 
msw.msb 
Isb 


WBUFBEG 
ADDR PTR 


CA+11 
CA+12 

CA+13 
CA+14 


Isw.msb 

Isb 
msw.msb 
Isb 


WBUFEND 
ADDR PTR 


CA+15 
CA+1 6 

CA+17 
CA+18 


Isw.msb 
Isb 

msw.msb 
Isb 


FIRST BYTE 
ADDR PTR 


CA+19 
CA+20 

CA+21 
CA+22 


Isw.msb 
Isb 

msw.msb 
Isb 


LAST BYTE 
ADDR PTR 



255 



64000 WRITE 
BUFFER 
(128 WORDS) 



INITIALLY 
SET TO 0 



CONTROL BUFFER 



Figure 8-14. Writing RS-232 Record - Pliase II 
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ADDRESS CONTENTS 



WBUFBEG 


FIRST BYTE 








LAST BYTE 




WBUFEND 



USER'S WRITE BUFFER 



ALL BYTES TRANSFERRED 



CA+1 
t 

CA+5 



CA+1 4 



CA+15 
CA+16_ 
' CA+17 
CA+18 



CA+19 
CA+20 
CA+21 
CA+22 



CONTENTS (FROM 64000) 



87H (OPEN WRITE BUFFER) 



SAME AS SHOWN 
FOR PHASE II 



#BYTES TRANSMITTED BY 
8251 SINCE BUFFER OPENED 



SAME AS SHOWN 
FOR PHASE II 



lsw,msb 

lsb_ _ 

msw.msb 
Isb 



FIRST BYTE 
ADDR PTR 



lsw,msb 



msw.msb 
Isb 



LAST BYTE 
ADDR PTR 



CONTROL BUFFER 



FIRST BYTE 



WRITE 
DATA 



8251 
USART 



TRANSMITTED 
DATA 



CONTROL , 
1 I CONTROL 



64000 

WRITE BUFFER 

(256 BYTES 128 WORDS) 



#BYTES TRANSMITTED 



_L_L 



64000 WRITE 
TO-8251 
ROUTINE 
WRITING DONE 
ON INTERRUPT 
BASIS 



Figure 8-15. Writing RS-232 Record - Phase III 



ADDRESS 



CONTENTS 



WBUFBEG 






FIRST BYTE 






WBUFEND 


LAST BYTE 



USER'S WRITE BUFFER 



ADDRESS 


CONTENTS 


CA 


89H 


CA+1 

T 

CA+5 


SAME AS SHOWN 
FOR PHASE II 




#BYTES TRANSMITTED BY 
8251 SINCE BUFFER OPENED 


CA+7 

CA+14 
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PHASE II 


CA+15 
CA+16 
CA+17 
CA+18 


Isw.msb 

FIRST BYTE 
msw.msb ADDR PTR 
Isb 


CA+19 
CA+20 
CA+21 
CA+22 


Isw.msb 

Isb LAST BYTE 
msw.msb ADDR PTR 
Isb 



255 



FIRST BYTE 



LAST BYTE 



64000 WRITE 
BUFFER 

(256 BYTES 128 WORDS) 



CONTROL BUFFER 



UPDATED BY 64000 



Figure 8-16. Writing RS-232 Record - Phase IV 
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ADDRESS 



CONTENTS 



RBUFBEG 








RBUFEND 





ADDRESS 



USER READ BUFFER 



'The actual address for 
location "CA" is defined 
by tfie user during 
configuration of the 
emulation "CMDFILE" 



CA* 



CA+1 



CA+39 



CONTENTS 



BUFFER RESERVED 
FOR RS-232 
10 PARAMETERS 
SENT WITH 
CONTROL CODES 



CONTROL BUFFER 

Figure 8-17. Reading RS-232 Record - Phase I 
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ADDRESS 
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RBUFBEG 






RBUFEND 



BYTE 0 
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CONTENTS (FROM USER PROG) 


CA 


8AH (OPEN READ BUFFER) 


CA+1 
f 

CA+22 
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& WRITE CONTROL BUFFER 


CA+23 
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Isw.msb 
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msw.msb 
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CA+28 
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CA+31 
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, CA+32 
CA+33 
CA+34 

^ CA+35 
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msw.msb 
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FIRST BYTE 
ADDR PTR 


CA+36 
CA+37 
CA+38 
CA+39 
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BYTE N 
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BUFFER 



.INITIALLY 
SET TO 0 



CONTROL BUFFER 



Figure 8-18. Reading RS-232 Record - Phase ii 
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CONTENTS 



RBUFBEG 


FIRST BYTE 








LAST BYTE 




RBUFEND 



USER'S READ 
BUFFER 



ADDRESS 


CONTENTS 


CA 


8AH (OPEN READ BUFFER) 


CA+1 
t 

CA+22 


SAME AS SHOWN 
FOR PHASE II 


CA+23 


#BYTES RECEIVED BY 
8251 SINCE BUFF OPENED 


CA+24 

CA+31 
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FOR PHASE II 


CA+32 
CA+33 
CA+34 
CA+35 


Isw.msb 

Isb FIRST BYTE 
msw.msb ADDR PTR 
Isb 


CA+36 
CA+37 


tsw.msb 

Isb LAST BYTE 


CA+3B 
CA+39 


msw.msb ADDR PTR 
Isb 



READ 
DATA 



8251 
USART 



RECEIVED 
DATA 



64000 READ 
BUFFER 



T 

"1 I CONTROL 



64000 
READ 8251 
ROUTINE 



64000 SETS POINTER TO 
LAST BYTE 



CONTROL BUFFER 



Figure 8-19. Reading RS-232 Record - Phase iii 
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ADDRESS 



CONTENTS 



RBUFBEG 






LAST BYTE 




RBUFEND 



USER'S READ BUFFER 
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CONTENTS 


CA 


8CH 


CA+1 
t 
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SAME AS SHOWN 
FOR PHASE 11 


CA+23 


#BYTES RECEIVED BY 8251 
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CA+24 
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FOR PHASE II 


CA+32 
CA+33 
CA+34 
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isb FIRST BYTE 
msw.msb ADDR PTR 
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CA+36 
CA+37 


lsw,msb 

Isb LAST BYTE 


CA+38 
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msw.msb ADDR PTR 
Isb 
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UPDATED BY 64000 
PROGRAM 



CONTROL BUFFER 



Figure 8-20. Reading RS-232 Record - Phase IV 
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Simulated I/O Error Codes 

The general definitions for the simulated I/O error codes are listed in table 8-8. Where 
applicable, more specialized definitions of these error codes are listed in individual I/O code 
tables, 8-1, 8-2, etc. 

When a request by the user program cannot be executed, the applicable error code is 
returned by the 64000 program to location OA. 

Table 8-8. Simulated I/O Error Codes - General Definitions 



Decimal (Hex) 

Code # Meaning 

00 No error - successful operation 

01 End of file 

02 Invalid disc 

03 File not found 

04 File already exists 

05 No disc space available 

06 No directory space available 

07 File is Corrupt (bad linkage) 

08 Cannot read/write assigned memory 

09 Request not allowed 

10 ( A ) Invalid file type 

11 ( B ) Invalid row or column no. 

12 ( C ) Invalid record length 

13 ( D ) Invalid display character >OFOH 

14 ( E ) While in simulated display I/O or simulated 

keyboard I/O, the 64000 "simulate" soft key 
was pressed to exit simulate I/O. All open 
files are closed. 

15 ( F ) Error in new disc file name when 



attempting to change a disc file name. 
First character in file name limited to 
capital letters A through Z. Second and 
following characters may contain capital 
and lower case letters, numerals 0 
through 9, underlines, and only if required 
to fill in the last byte of the last word, 
a blank is used. 
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Simulated I/O Sample Programs 

The following figures show the listing for source programs which actually use simulated I/O 
facilities. The programs are real and do work. 



Figure # 


Sample Program Type 


8-21 


Simulated Display I/O - Sample Program A 


8-22 


Simulated Display I/O - Sample Program B 


8-23 


Simulated Keyboard, Display, and One Disc 




File I/O - Sample Program 


8-24 


Simulated Keyboard, Display, and Two Disc 




Files I/O - Sample Program 
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"8080" 

*This 8080 program uses the simulated display I/O interface. 

*The display is opened, and two messages are written; one to row/column 2,40 and one to 
*row/column 18,20. 

* Control address for display is OOOOH. 

* Program execution should start at 0200H. 



USR_ADR EQU 0 

START 

*OPEN 



'SET 



WRITE MESSAGE 1 



SET ROW/COLUMN 18/20 



WRITE MESSAGE 2 



LOOP HERE, LEAVE DISPLAY OPEN 



ORG 200H 

LXI SP,100H 
DISPLAY 
MVI A,80H 
STA USR_ADR 
CALL WAIT 
ROW/COLUMN 2/40 
MVI A, 2 

STA USR_ADR+1 
MVI A,40 
STA USR_ADR+2 
MVI A,83H 
STA USR_ADR 
CALL WAIT 

LXI H,MESSAGE_1 
CALL XFR_MSG 
CALL WAIT 

MVI A,18 

STA USR_ADR+1 

MVI A,20 

STA USR_ADR+2 

MVI A,83H 

STA USR_ADR 

CALL WAIT 

LXI H,MESSAGE_2 
CALL XFR_MSG 
CALL WAIT 



WAIT FOR USR_ADR=0 ... lO 
WAIT 



JMP $ 
REQUEST COMPLETED 

LDA USR_ADR 
CPI 0 
JM WAIT 
RET 



Figure 8-21. Simulated Display I/O - Sample Program A 



EMULATOR/ANALYZER 6809/6809E 8- 



TRANSFER MESSAGE FROM C(DE) TO USR_ADR+1 
''C(DE(0))=#BYTES 
* C(DE(1))=BYTE 1 



* 
* 

* C(DE(N))=BYTE N 

*USR_ADR=84H ... REQUEST TO WRITE ROW/COLUMN 
XFR_MSG 

XCHG 
LDAX D 
MOV B,A 
INX D 

LXI H,USR_ADR+1 
INX H 
MOV M,A 
INX H 



XFR_LOOP 



LDAX D 
MOV M,A 
INX D 
INX H 
DOR B 
MOV A,B 
CPI 0 

JNZ XFR_LOOP 
MVI A,84H 
STA USR_ADR 
RET 



;B=#BYTES 
;HL=USR_ADR+1 



GET DATA BYTE 
AND STORE IN USR_ADR 
BUFFER 

;AND CHECK FOR COMPLETION 



;SET REQ FOR WRITE 
; ROW/COLUMN 



MESSAGE 1 



MESSAGE _1 



DB 12 

ASC "Display test" 



;#BYTES 



MESSAGE 2 



MESSAGE_2 



DB 8 

ASC "End test" 
END START 



;#BYTES 



Figure 8-21. Simulated Dispiay i/0 - Sampie Program A (Cont'd) 
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This program scrolls ASCII characters onto the 64000 Display. 



"8080" 
DISP 

START 



LOOP 



CHECK 



EQU 

LXI 

LXI 

CALL 

MVI 

INX 

MVI 

INX 

IVIVI 
INX 
INR 

MOV 

INX 

MVI 

INX 

MVI 

LXI 

MVI 

CALL 

MVI 

CMP 

JNZ 

MVI 

JMP 

LDA 

CPI 

RZ 

JMP 

END 



ODOOH 

SP.IOOOH 

H.DISP 

CHECK 

B,0 

H 

M,4 
H 

M,32 

H 

B 

M,B 
H 

M,32 
H 

M,0 

H.DISP 

M,82H 

CHECK 

A, 127 
B 

LOOP 

B, 0 
LOOP 
DISP 
0 

CHECK 
START 



CONTROL ADDRESS FOR 
SIMULATED DISPLAY 10 

STACK DOWN FROM OFFFH 

LOAD H WITH CA 

WAIT FOR SERVICE 

INITIALIZE COUNTER 

SET M TO DISP+1 

SET BYTE COUNT TO FOUR 
CHARACTERS/LINE 

SET M TO DISP+2 

THEN EACH LINE IS: 

ASCII BLANK (1ST CHAR) 



THEN: 
2ND CHAR 
THEN 

ANOTHER BLANK (3RD CHAR) 

;AND A "NULL" (4TH CHAR) 

REQ "SCROLL" 1 LINE 
WAIT FOR SERVICE 
AVOID SPECIAL CHARACTERS 
IF B > 127 RESET B TO 0 



;WAIT UNTIL CA=0 



Figure 8-22. Simulated Display I/O - Sample Program B 
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"8080" 

ORG 0 

* THIS PROGRAM OPENS KEYBOARD AND DISPLAY FILE. THEN, UPON 

* CARRIAGE RETURN IT COPIES KEYBOARD DATA TO DISPLAY AND FILE 

* FIO. 

* OPEN DISPLAY AND KEYBOARD 
START 

LXI SP,400H 
MVI A,80H 
STA DSP_BUF 
STA KEY_BUF 
MVI A,02H 
STA FILE_BUF+1 
MVI A,0 

STA FILE_BUF+2 
MVI A,83H 
STA FILE_BUF 
WAIT_FILE_D 

LDA FILE_BUF 
CPI 0 

JM WAIT_FILE_D 
MVI A,80H 
STA FILE_BUF 
WAIT_FILE_C 

LDA FILE_BUF 
CPI 0 

JM WAIT_FILE_C 
NEXT_KEY_DATA 
MVI A,-2 
STA KEY_BUF+1 
MVI A,240 
STA KEY_BUF+2 
LDA K_CMD 
STA KEY_BUF 

* WAIT FOR CR(CMD>=0) 
WAIT_FOR_CR 

LDA KEY_BUF 
CPI 0 

Figure 8-23. Simulated Keyboard, Display, and One Disc File I/O - Sample Program 



;OPEN DISPLAY 

;DELETE FILE 
;TYPE 2(SCR) 
;DISC#0 

;WAIT FR FILE DELETE 

;CREATE FILE 

;WAIT FOR FILE CREATE 

;NOW SETUP KEYBOARD FOR CMD=-2 

;AND MAX # CHARS 

;AND OPEN/READ KEYBOARD 
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JM WAIT_FOR_CR 
LXI D,DSP_BUF+1 
CALL XFR_DATA 

* WRITE TO DISPLAY 

MVI A,82H 
STA DSP_BUF 
WAIT_FOR_DSP 

LDA DSP_BUF 
CPI 0 

JM WAIT^FOR.DSP 

* WRITE TO FILE FIO 

LXI D,FiLE_BUF+1 

CALL XFFLDATA 

LDA KEY_BUF+3 

INR A 

STC 

CMC 

RAR 

STA FILE2BUF+1 ;SET # WORDS 

MVI A,89H 
STA FILE_BUF 
WAIT_FILE_W ;WAIT FOR FILE WRITE 

LDA FILE_BUF 
CPI 0 

JM WAIT_FILE_W 
JMP NEXT_KEY_DATA 

* 

* TRANSFER KEY BOARD DATA TO DISPLAY 
XFR_DATA 

LXI H,KEY_BUF+3 

MOV B,M ;GET # BYTES 

MOV A,B 
STAX D 
INX D 
INX H 

Figure 8-23. Simulated Keyboard, Dispiay, and One Disc Fiie I/O - Sample Program (Cont'd) 
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XFR_LOOP 
MOV A,M 
STAX D 
INX D 
INX H 
DCR B 

JNZ XFR_LOOP 
MVI A,0 
STAX D 
RET 
K_CMD DB 80H 

* DISPLAY BUFFER 
DSP_BUF EQU 100H 

* KEYBOARD BUFFER 
KEY_BUF EQU 200H 
FILE_BUF EQU 300H 

ORG 100H 
DB 0 

ORG 200H 
DB 0 

ORG 300H 
DB 0 

END START 

Figure 8-23. Simulated Keyboard, Display, and One Disc File I/O - Sample Program (Cont'd) 
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"8080" 

ORG 0 

* THIS PROGRAM OPENS KEYBOARD, DISPLAY AND 2 FILES. THEN UPON 

* CARRIAGE RETURN IT COPIES KEYBOARD DATA TO DISPLAY AND TO 

* FILES F1 AND F2. 



* OPEN DISPLAY AND KEYBOARD 
START 

LXI SP,400H 

MVI A,80H 

STA DSP_BUF 

STA K_CMD 

MVI A,2 



;STACK 03FFH AND BELOW 
;OPEN DISPLAY 



STA FB1+1 
MVI A,0 
STA FB1+2 
STA FB2+2 
MVI A,83H 
STA FB1 
WAIT_FILE_D1 
LDA FBI 
CPI 0 

JM WAIT_FiLE_D1 



TYPE 2(S0URCE) 

DISC#0 

BOTH FILES ON DISC 0 



;WAIT FOR FILE DELETE 



MVI A,80H 
STA FBI 
WAIT_FILE_C1 
LDA FB1 
CPI 0 

JM WAIT_FILE_C1 
MVI A,2 
STA FB2+1 
MVI A,83H 
STA FB2 
WAIT_FILE_D2 
LDA FB2 
CPI 0 

JM WAIT_FILE_D2 



;CREATE FILE 



WAIT FOR FILE CREATE 



;TYPE 2(SCR) 



WAIT FOR FILE DELETE 



Figure 8-24. Simulated Keyboard, Display, and Two Disc Flies I/O Sample Program 
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MVI A,80H ;CREATE FILE 

STA FB2 

WAIT_FILE_C2 ;WAIT FOR FILE CREATE 

LDA FB2 
CPI 0 

JM WAIT_FILE_C2 
NEXT_KEY_DATA 

MVI A,-2 ;NOW SETUP KEYBOARD FOR CMD=-2 

STA KEY_BUF+1 

MVI A,240 ;AND MAX # CHARS 

STA KEY_BUF+2 

LDA K_CMD ;AND OPEN/READ KEYBOARD 
STA KEY_BUF 

* WAIT FOR CR(CMD>=0) 
WAIT_FOR_CR 

LDA KEY_BUF 
CPI 0 

JM WAIT_FOR_CR 
LXI D,DSP_BUF+1 
CALL XFR_DATA 

* WRITE TO DISPLAY 

MVI A,82H 
STA DSP_BUF 
WAIT_FOR_DSP 

LDA DSP_BUF 
CPI 0 

JM WAIT_FOR_DSP 

* WRITE TO FILE F1 

LXI D,FB1+1 

CALL XFR_DATA 

LDA KEY_BUF+3 

INR A 

STC 

CMC 

RAR 

STA FB1+1 ;SET # WORDS 

MVI A,89H 
STA FBI 

Figure 8-24. Simulated Keyboard, Display, and Two Disc Files I/O Sample Program (Cont'd) 
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WAIT_FILE_W1 ;WAIT FOR FILE WRITE 

LDA FBI 
CPI 0 

JM WAIT_FILE_W1 

* WRITE TO FILE F2 

LXI D,FB2+1 

CALL XFR_DATA 

LDA KEY_BUF+3 

INR A 

STC 

CMC 

RAR 

STA FB2+1 ;SET # WORDS 

MVI A,89H 
STA FB2 

WAIT_FILE_W2 ;WAIT FOR FILE WRITE 

LDA FB2 
CPI 0 

JM WAIT_FILE_W2 
JMP NEXT_KEY_DATA 

* 

* TRANSFER KEY BOARD DATA TO DISPLAY 
XFR_DATA 

LXI H,KEY_BUF+3 

MOV B,M ;GET # BYTES 

MOV A,B 
STAX D 
INX D 
INX H 
XFR_LOOP 

MOV A,M 
STAX D 
INX D 
INX H 
DCR B 

Figure 8-24. Simulated Keyboard, Dispiay, and Two Disc Fiies I/O Sample Program (Cont'd) 
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K_CMD 
DSP_BUF 



JNZ XFR_LOOP 

MVI A,0 

STAX D 

RET 

DB 80H 

ORG 100H 

DB 0 



;CONTROL ADDRESS FOR DISPLAY 



ORG 200H 
KEY_BUF DB 0 



;CONTROL ADDRESS FOR KEYBOARD 



FB1 



ORG 300H 
DB 0 



.CONTROL ADDRESS FOR FILE 1 



FB2 



ORG 400H 
DB 0 

END START 



;CONTROL ADDRESS FOR FILE 2 



Figure 8-24. Simulated Keyboard, Dispiay, and Two Disc Files I/O Sample Program (Cont'd) 
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64000 File Formats 

The 64000 file accessible to the user through the simulated disc file I/O interface are 
described in the following paragraphs. 

Assembler Symbols File (File Type 12) 

This file contains the symbols and their corresponding values assigned by the assembler. It 
also indicates the symbol type. Symbols may be either ABS (absolute), or relocatable to the 
PROG, DATA, or COMN areas. (These terms are all defined in the 64000 Assembler/Linker 
Reference Manual.) 

The assembler symbols file is generated each time a source program containing symbols is 
assembled into an object file. The file consists of a group of records with each record in turn 
consisting of up to 128 sixteen-bit words (0-127). Each record must be structured as follows: 
(See figures 8-25 and 8-26). 

• Record Identification (ID) Word 

• Symbol Definition Blocks (Length variable from, two to ten words.) 

• Checksum Word 

Each of the three items is described in the following paragraphs. 

Record ID word - The ID word is always the first word in each record and contains the 
number "6". (The "6" is used internally and is not to be confused with the file type 
number which is 12.) 

Symbol definition blocks - A symbol definition block consists of the symbol word(s) 
and the value word(s). (See figure 8-27.) 

Symbol word(s) - The ASCII character, or characters, are contained in this word (or 
words). From one to fifteen ASCII characters may be defined. To specify a single- 
character symbol, only one symbol word is required. To specify either 14 or 15 ASCII 
characters, the maximum of eight words is required. (Symbols longer than 15 
characters are truncated to 15 characters.) 

First symbol word - The first word in each symbol definition block is structured the 
same. The least significant eight bits (7 thru 0) contain the first ASCII character in the 
symbol. The most significant eight bits (15 thru 8) always contain the following 
information: 
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• Symbol Length (SL) - Bits 15, 14, and 13 specify the number of symbol words -1 in this 
block. (See figure 8-28, Example A.) For example, if the symbol consists of two ASCII 
characters, which require two symbol words, SL is equal to 1. Examples of symbols 
made up of one to five characters, which require one and three words respectively, are 
shown in figure 8-28, examples B and C. 

• Reserved Bits - Bits 12, 11, and 10 contain 000 and are reserved for use by other 
program modules. 

• Memory Relocation (Relo) - Bits 9 and 8 specify how the symbol may be relocated as 
follows: 



Bit 9 Bit 8 Storage Type 

0 0 ABS (Absolute) 

0 1 PROG area 

1 0 DATA area 
1 1 COMN area 



Additional symbol words - The second thru the eighth symbol words may each contain up to 
two ASCII characters. However, if in the last symbol word, only one byte is required to define 
the last symbol character, then the least significant byte in that word must contain an ASCII 
blank (Code 20H). That is, the two bytes in each symbol word must contain meaningful data, 
even in the last word. 

The symbol words must be packed. Only the words actually required to specify the symbols 
are to be used. Thus, if five symbol words are required to define a symbol, then only five 
symbol words must be used. 

Value word(s) - Immediately following the last symbol word may be either one or two value 
words, depending upon the size of the target processors addressable memory. This word ,or 
words, specifies the value assigned to the symbol by the assembler. If the value can be 
contained in one 16-bit word, then only one word is to be used. Two 16-bit words are used 
only if they are both required. When two words are used, the first word contains the least 
significant 16-bits and the second word contains the most significant 16 bits. 

All symbol definition blocks within the assembler symbol file must be structured as defined 
above. 

Checksum Word - The checksum word must be the last word in the assembler symbols file. If 
the file is completely full, then the checksum word will be the 128th word (word #127). 
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The checksum word contains the arithmetic sum of the binary values of the preceding words 
in the file. 

User Buffer/Assembler Symbols File Packing Formats 

The format relationship between the user buffer when reading from, or writing into, a 64000 
Assembler Symbols File is shown in figure 8-27. 

Linker Symbols File (File Type 13) 

The Linker Symbols File is generated any time program modules are linked together. It 
consists of the following three types of records (see figure 8-29): 

• Microprocessor Configuration Record (one per file) 

• Globol Symbols Records 

• Program Names Records 

Each of these items is described below. 

Microprocessor Configuration Record (See figure 8-30) - The microprocessor configuration 
record is the first record in the Linker Symbols File and only one is allowed per file. This 
record identifies the microprocessor for which the program modules were configured. 

This is a fixed length record and consists of 25 words configured as follows: 

• One Record Identification (ID) Word 

• 15 Pad Words (contain all zeros) 

• Eight Words Allocated To: 

Microprocessor Name (9 characters, maximum) 
Microprocessor ID (6 characters, maximum) 

• One Checksum Word 

Each of these items is described below. 

Record identification (ID) word - The record ID word is always the first word in the record. In 
this case, it is also the first word in the Linker Symbols File and contains the number "1 ". This 
number identifies the record as the microprocessor configuration record. (The "1" is used 
internally and should not be confused with the file type number which is "13".) 
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Pad words 1 thru 15 - These words are inserted so that word positions 16 thru 23 in this name 
record contain the same data as do the corresponding word positions in the name records of 
the relocatable files. 

Name and user ID word block - An eight word block (words 16 thru 23) is allocated to contain 
the name and user ID words. This is the same ID entered into the 64000 in response to the 
user ID prompt. This block is always eight words long even if all words are not required to 
define the microprocessor name and user ID. These eight words are structured as follows: 

a. Word 16 - This is the first word and user ID word. The least significant eight bits (7-0) in 
this word contain the first ASCII character of the microprocessor name. The most 
significant eight bits (15-8) always contain the following information: 

• Microprocessor Name Length (MNL) - Bits 15, 14, and 13 specify the number of 16- 
bit words -1 used in a name. The minimum number of characters that may be used 
in the name is one that requires one word. Thus, the minimum value for IVINL is 0. 
The maximum number of characters that may be used in the name is nine which 
requires five words. Thus, the maximum value for MNL is four. (See "Words 17 thru 
23" below.) 

• User ID Length (IDL) - Bits 12 and 11 specify the actual number of 16-bit words 
required for the user ID. (Note that IDL differs from MNL in that IDL specifies the 
actual number of words and MNL specifies the number of words -1.) The maximum 
number of characters that may be used in the user ID is six, which requires three 
words. Thus, the maximum value for IDL is 3. 

• Bits 10-8 contain all zeros. 

b. Words 17 thru 23 - These words are used for the remaining name and user ID 
characters. The name characters are specified first, followed by the user ID characters. 
However, name and ID characters cannot be mixed within the same word. An unused 
least significant byte in either a name or ID word must contain an ASCII blank (code 
20H). The name and ID words must be packed. That is, the ID words must follow the 
name words with no intervening unused words. Unused words must be at the end of 
the block. 

Checksum word 24 - The checksum word contains the arithmetic sum of the binary values of 
the preceding 24 words in this record. 

Global Symbols Records (see figure 8-31) - The Linker Symbols File may contain multiple 
Global Symbols Records. The first Global Symbol Record follows the microprocessor 
Configuration Record and all succeeding Global Symbol Records are contiguous. 
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A Global Symbols Record contains the global symbols and the relocated address values 
(symbol values) generated \Nhen the program modules are linked. Each record may consist of 
up to 128 sixteen-bit words (words 0-127) structured as follows: 

• One Record Identification (ID) Word 

• Multiple Global Symbol Definition Blocks 

• One Checksum Word 

Each of these items is described in the following paragraphs. 

Record identification (ID) word - The ID word is always the first word in each record and 
contains the number "2". (The "2" is used internally and is not to be confused with the file 
type number which is 13.) 

Global symbol definition blocks - A global symbol definition block consists of the symbol 
word(s) and the value word(s). (See figure 8-31.) 

Symbol word(s) - The ASCII character, or characters, are contained in this word (or words). 
From one to fifteen ASCII characters may be defined. To specify a single-character symbol, 
only one symbol word is required. To specify either 14 or 15 ASCII characters, the maximum 
of eight words is required. (Symbols longer than 15 characters are truncated to 15 characters. 

First symbol word - The first word in every symbol definition block is structured the same. 
The least significant eight bits (7 thru 0) contain the first ASCII character in the symbol. The 
most significant eight bits (15 thru 8) always contain the following information. (See figure 8- 
32.) 

• Global Symbol Length (GSL) - Bits 15, 14, and 13 specify the number of symbol words 
-1 in this block. For example, if the global symbol consists of two ASCII characters, 
which require two symbol words, GSL is equal to 1. (The second byte in the second 
word will contain an ASCII blank, i.e. code 20H.) 

• Reserved Bits - Bits 12, 11, and 10 contain 000 and are reserved for use by other 
program modules. 
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• Memory Relocation (Relo) - Bits 9 and 8 specify how tlie symbol may be relocated as 
follows: 



Bit 9 



Bit 8 



Storage Type 



0 
0 
1 
1 



0 
1 
0 

1 



ABS (Absolute) 



PROG area 
DATA area 
COMN area 



Additional symbol words - The second thru the eighth symbol words may each contain up to 
two ASCII characters. However, if in the last symbol word, only one byte is required to define 
the last symbol character, then the least significant byte in that word must contain an ASCII 
blank (code 20H). That is the two bytes in each symbol word must contain meaningful data, 
even in the last word. 

The symbol words must be packed. Only the words actually required to specify the symbols 
are to be used. Thus, if five symbol words are required to define a symbol, then only five 
symbol words must be used. 

Symbol value words(s) - Immediately following the last symbol word may be either one or two 
value words depending upon the size of the target processors addressable memory. This 
word (or words) specifies the value assigned to the symbol by either the assembler (if ABS - 
absolute) or by the linker. If the value can be contained in one 16-bit word, then only one 
word is to be used. Two 16-bit words are used only if they are both required. When two words 
are used, the first word contains the least significant 16-bits and the second word contains 
the most significant bits. 

All global symbol definition blocks within the Linker Symbols File must be structured as 
defined above. 

Checksum word - The checksum word must be the last word in each record. If the record is 
completely full, then the checksum word will be the 128th word (word #127). 

The checksum word contains the arithmetic sum of the binary values of the preceding words 
in the record. 

Program Names Records (see figure 8-33) - The Linker Symbol File may contain multiple 
Program Names Records. The first Program Names Record follows the last Global Symbols 
Record. All succeeding Program Names Records are contiguous. 
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A Program Names Record contains the names of the programs, the corresponding user ID'S 
and the load addresses generated when the program modules are linked. Each record may 
consist of up to 128 sixteen-bit words (words 0-127) structured as follows: 

• One Record Identification (ID) Word 

• Multiple Program Name and Addresses Definition Blocks (Fixed length blocks of 14 
words each) 

• One checksum word 

Each of these items are described in the following paragraphs. 

Record identification (ID) word - The ID word is always the first word in each record and 
contains the number "3". (The "3" is used internally and is not to be confused with the file 
type number which is 13.) 

Program name and addresses definition block - This is a fixed length block consisting of 14 
sixteen-bit words allocated as follows: 

• Eight words reserved for the program name and users ID 

• Six words reserved for the linker load addresses (see figure 8-34) 

Program name and user ID words - The formatting and packing of these words are done in 
the same way as described above for the "Microprocessor Configuration Record, Name and 
ID Word Block". 

Load address words - These words contain the load addresses assigned by the linker. If an 
address is not assigned to a particular area, the address words contain zeros (OOOOH). The 
MS 16-bit address word will be used only if required by the target microprocessors 
addressable memory space. 

Checksum word - The checksum word must be the last word in each record, if the record is 
completely full, then the checksum word will be the 128th word (word #127). 

The checksum word contains the arithmetic sum of the binary values of the preceding words 
in the record. 
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User Buffer/Linker Symbols File Packing Formats 

The format relationship between the user buffer when reading or writing into a 64000 Linker 
Symbols File is the same as shown for the Assembler Symbols File in figure 8-27. 

Source File (File Type 2) 

The source file is generated by the programmer from the applicable microprocessor opcodes 
and assembler pseudo instructions. It consists of a series of ASCII records. (See figures 8-35 
and 8-36.) 

Each ASCII source record in the file is structured the same. An ASCII source record is of 
variable length and may contain up to 128 sixteen-bit words. Each 16-bit word contains two 
8-bit ASCII bytes. If the last byte in the last word of a record is not used, it must contain an 
ASCII blank (20H). 

The format relationship between the user buffer when reading from or writing into a 64000 
source file is also shown in figure 8-36. 

Listing File (File Type 5) 

The listing file is a copy of a source file. It may be produced when listing to a printer, a 
display, etc. The format is identical to that described above, and shown in figures 8-35 and 
8-36 for the source file. 

Absolute File (File Type 4) 

Absolute file is generated when the linker produces an absolute image of an object file or 
files. The absolute file contains two types of records; the first record and the additional 
records which follow the first record. (See figures 8-37 and 8-38.) 

First record - The first record has a fixed length of four 16-bit words. The first word (word 0) 
specifies the processors data bus width (8, 16, etc.). The second word (word 1) specifies the 
data width base of the target microprocessor. The data width base is the minimum 
addressable entity (i.e. group of bits) used by the microprocessor. Normally this will be 8-bits, 
but not always. 

The last two words specify the transfer address value loaded into the target microprocessor's 
program counter. The most significant transfer address word (bits 31 thru 16) is used only if 
required. If not used it will contain OOOOH. 

Additional records - All records following record one are formatted the same. Each is a 
variable length record consisting of up to 128 sixteen-bit words (0-127). 
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The first word in tlie record (word 0) specifies tlie number of data bytes in the record (2 
bytes/word). The following two words (words 1 and 2) specify the load address for this 
record. (The load address is the beginning location for storing this record.) The most 
significant load address word (bits 31 thru 16) will be used only if required. If not used, bits 31 
thru 16 will contain OOOOH. 

The remaining words in the record (3 thru n) contain the data bytes. If the last byte in the last 
word of a record is not used for data, it must contain an ASCII blank (code 20H). 

The format relationship between the user buffer when reading from or writing into a 64000 
absolute file is also shown in figure 8-38. 

Relocatable File (File Type 3) 

The relocatable file is produced by the assembler or compiler. It contains information 
required by the linker to construct an absolute file. This file consists of the following six types 
of records (see figure 8-39): 

• Program Description Record (one per file) 

• Global Symbols Record 

• Data Record 

• External Symbols Record 

• Local Symbols Record (optional) 

• End Record (one per file) 

Each type of record is defined in the following paragraphs. 

Program Description Record (see figure 8-40) - The program description record is the first 
record in the Relocatable File and only one is allowed per file. This record identifies the 
source program, number of externals, microprocessor, comments, and absolute code 
definitions. 
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This is a variable length record (up to 128 words) and is configured as follows: 



• One Record Identification (ID) Word 

• 14 words allocated to: 

Source Program Name (9 characters, maximum) 
Source Program ID (6 characters, maximum) 
PROG Area Length (2 words, maximum) 
DATA Area Length (2 words, maximum) 
COMN Area Length (2 words, maximum) 

• One word allocated to definition of the number of external variables and procedures 
defined in the module. 

• Eight words allocated to: 

Microprocessor Name (9 characters, maximum) 
Microprocessor ID (6 characters, maximum) 

• Two words allocated to: 

Date (one word, maximum) 
Time (one word, maximum) 

• 11 words allocated to comments 

• Up to 88 words allocated to absolute code segment description. 

• One checksum word 

Each of these items is described as follows: 

Record identification (ID) word - The record ID word is always the first word in the record. In 
this case, it is also the first word in the Relocatable File and contains the number "1". This 
number identifies the record as the source program description record. (The "1" is used 
internally and should not be confused with the file type number which is "3".) 
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Source program name and user ID word block - An eight word block (words 1 thru 8) is 
allocated to contain the source program name and user ID words. This is the same ID entered 
into the 64000 in response to the user ID prompt. This block is always eight words long even 
if all words are not required to define the source program name and user ID. These eight 
words are constructed as follows: 

a. Word 1 - This is the first word and user ID word. The least significant eight bits (7-0) in 
this word contain the first ASCII character of the source program name. The most 
significant eight bits (15-8) always contain the following information: 

• Source Program Name Length (PNL) - Bits 15, 14, and 13 specify the number of 16- 
bit words -1 used for the name. The minimum number of characters that may be 
used in the name is one, which requires one word. Thus, the minimum value for 
PNL is zero. The maximum number of characters that may be used in the name is 
nine, which requires five words. Thus, the maximum value for PNL is four. (See 
"Words 2 thru 8", below.) 

• User ID Length (IDL) - Bits 12 and 11 specify the actual number of 16-bit words 
required for the user ID. (Note that IDL differs from PNL in that IDL specifies the 
actual number of words and PNL specifies the number of words -1 .) The maximum 
number of characters that may be used in the user ID is six, which requires three 
words. Thus, the maximum value for IDL is 3. 

• Bits 10-8 contain the number of the disc which holds the record. 

b. Words 2 thru 8 - These words are used for the remaining name and user ID characters. 
The name characters are specified first, followed by the user ID characters. However, 
name and ID characters can not be mixed within the same word. An unused least 
significant byte in either a name or ID word must contain an ASCII blank (code 20H). 
The name and ID words must be packed. That is - the ID words must follow the name 
words with no intervening unused words. Unused words must be at the end of the 
block. 

Length word block - A six word block (words 9 thru 14) is allocated to contain the word 
lengths of code produced by the assembler or compiler in each of the three relocatable 
sections; PROG, DATA, and COMN. 

Number of externals word - One word (word 15) is allocated to contain the number of 
external variables and procedures defined in the module. This number can be from 0 to 51 1 . 

Microprocessor name and user ID word block - This word block is the same as described for 
the Linker Symbols File under the "Microprocessor Configuration Record, Name and User ID 
Word Block". 
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Date and time word block - Two words (words 24 and 25) are allocated to contain the date 
and time that the program was assembled or compiled. 

Comments word block - A block of eleven words (words 26 thru 36) is allocated for 
comments. The block contains up to 22 ASCII characters defined by the NAME psuedo in the 
assembler or compiler. All unused characters must contain ASCII blanks (code 20H). 

Absolute code segment word block - A variable length block which contains from 0 to 22 
entries of four 16-bit words is allocated for absolute code segments. Each four-word entry 
defines an absolute code segment declared in the assembler or compiler. 

Checksum word - The checksum word must be the last word in each record. If the record is 
completely full, then the checksum word will be the 128th word. (Word #127.) 

The checksum word contains the arithmetic sum of the binary values of the preceding words 
in the record. 

Global Symbols Records (see figures 8-31 and 8-32) - The global symbols record formatting 
and packing for the Relocatable File is the same as described for the Linker Symbols File 
under the "Global Symbols Records". 

Data Records (see figure 8-41) - The data records contains the relocation area and address of 
the program as assigned by the linker. It also defines how the absolute codes are produced. 

Record identification (ID) word - The ID word is always the first word in each record and 
contains the number "3". (The "3" is used internally and is not to be confused with the file 
type number, which is also "3". 

Relocation address words - These words contain the relocation address assigned by the 
linker to this program. The most-significant word is used only when the ID offset equals 3. 

Relocation word - The relocation word identifies the relocation destination code as follows: 
00=ABS, 01=PROG, 10=DATA, and 11=COMN. 
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Event selection word - This word contains codes 00, 01, 10, and 11 in bit locations T1 thru T8. 
Any one of the codes may be contained in any of the locations. As T1 thru T8 are read, the 
event selected by the specific code will be executed. Codes are defined as follows: 

Tn=00 Produce one byte of absolute code, which is found in the low order byte of 
the corresponding word. 

Tn=01 Produce two bytes of absolute code, which is found in the corresponding 
word. 

Tn=10 Relocate the address to be found in the second (and optionally, the third) 
word based on the relocation code in the first word. Then produce an 
absolute code based on the processor dependent format number in the first 
word and skeleton, if used. 

Tn=11 Look up the external symbol whose number is in the first word (which has 
been previously defined in a type 4 record). Add the displacement and then 
produce an absolute code based on the format number and skeleton, if used. 

Checksum word - The checksum word must be the last word in each record. If the record is 
completely full, then the checksum will be the 128th word (word #127). 

The checksum word contains the arithmetic sum of the binary values of the preceding words 
in the record. 

External Symbols Records (see figure 8-42) - The Relocatable File may contain multiple 
External Symbols Records. 

An External Symbols Record contains the external symbols and the external ID number 
assigned by the assembler or compiler. Each record may consist of up to 128, sixteen-bit 
words (words 0-127) structured as follows: 

• One Record Identification (ID) Word 

• Multiple External Symbol Definition Blocks 

• One Checksum Word 

Each of these items is described as follows: 

Record identification (ID) word - The ID word is always the first word in each record and 
contains the number "4". (The "4" is used internally and is not to be confused with the file 
number, which is "3".) 
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External symbol definition blocks - An external symbol definition block consists of the 
symbol word(s) and the external ID number. (See figure 8-42.) 

Symbol words - The ASCII character, or characters, are contained in this word, or words. 
From one to fifteen ASCII characters may be defined. To specify a single-character symbol, 
only one symbol word is required. To specify either 14 or 15 ASCII characters, the maximum 
of eight words is required. (Symbols longer than 15 characters are truncated to 15 
characters.) 

First symbol word - The first word in every symbol definition block is structured the same. 
The least significant 8 bits (7-0) contain the first ASCII character in the symbol. The most 
significant eight bits (15-8) always contain the following information : 

• External Symbol Length (ESL) - Bits 15, 14, and 13 specify the number of symbol 
words -1 in this block. For example, if the external symbol consists of two ASCII 
characters, which requires two symbol words, then ESL is equal to 1 . (The second byte 
in the second word will contain an ASCII blank - i.e. code 20H.) 

• Reserved Bits - Bits 12, 11, 10, 9, and 8 always contain 00100. 

Additional symbol words - The second thru the eighth symbol words may each contain up to 
two ASCII characters. However, if in the last symbol word, only one byte is required to define 
the last symbol character, then the least significant byte in that word must contain an ASCII 
blank (code 20H). That is, the two bytes in each symbol word must contain meaningful data, 
even in the last word. 

The symbol words must be packed. Only the words actually required to specify the symbols 
are to be used. Thus, if five symbol words are required to define a symbol, then only five 
words are to be used. 

External ID number word - The external ID number is assigned by the assembler or compiler. 
The number can be from 0 to 511. 

Checksum word - The checksum word must be the last word in each record. If the record is 
completely full, then the checksum will be the 128th word (word #127). 

The checksum word contains the arithmetic sum of the binary values of the preceding words 
in the record. 

Local Symbols Records (see figures 8-31 and 8-32) - The local symbols records formatting 
and packing for the Relocatable File is the same as described for the Linker Symbols File 
under the "Global Symbols Records", except the ID word contains the number "6". 
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End Record (see figure 8-43) - The end record is the last record in the Relocatable File and 
only one is allowed per file. The end record contains the relocation code and transfer 
address. Each record consists of five, 16-bit words structured as follows: 

• One Record Identification (ID) Word 

• One Relocation Word 

• Two Transfer Address Words 

• One Checksum Word 

Each of these items are described as follows: 

Record identification (ID) word - The ID word is always the first word in each record and 
contains the number "5". (The "5" is used internally and is not to be confused with the file 
number, which is "3".) 

Relocation word - The relocation word identifies the relocation destination code, as follows: 
00=ABS, 01=PROG, 10=DATA, and 11=C0MN. 

Transfer address words - The transfer address words contain the address where control will 
be transferred to when the program is run. 

Checksum word - The checksum word must be the last word in each record. The checksum 
word contains the arithmetic sum of the binary values of the preceding words in the record. 

User Buffer/Relocatable File Packing Formats 

The format relationship between the user buffer when reading from, or writing into, a 64000 
Relocatable File is the same as shown for the Assembler Symbols File in figure 8-27. 
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Record 
Word # 



7 



Record 
no. 1 



k (n£127)^ 

/ 0 



Record 
no. 2 



Contents 



Record ID Word = 6 



First Symbol Definition Block 
(Variable length: 2 to 10 words) 




Last Symbol Definition Block 
(Variable length: 2 to 10 words) 



Checksum word for record 1 



Record ID word = 6 



First Symbol Definition Block 
(Variable length: 2 to 10 words) 



Last Symbol Defmition Block 
(Variable length: 2 to 10 words) 



Checksum word for record 2 



Record ID word = 6 




Figure 8-25. Assembler Symbol File Overall Structure 
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ASSEMBLER SYMBOL RECORD STRUCTURE 



Word 
n 



Record 
Type 



First 
Symbol 
Definition 

Block 

Variable 
length 
block ■ 
(2 words mm/ 
10 words max.) 



Second 
Symbol 
Definition 
Block' 



ID Word = 6 



Symbol word or words 
Identifies symbol characters and 
the part of memory m which they 
are defined, i.e. ABS. Prog, Data, or 
Common. 

(LI = 1 to 8 words) 



Symbol value" 



(L2 = 1 or 2 words! 



Symbol Word(s) 



Symbol Value" 



Identifies record as an 
Assembler Symbol Record. 



Symbol words and value words 
must be packed If only one symbol 
word and one value word are 
required, then only two words are 
used in the definition block 



LS 16-bit 
Word 



MS 16-bit 

Word 



MS Word IS 
used only if 
required to 
specify symbol 
value 



(n<127) 




Contains the anthmetic 
sum of the binary 
values of words 
0 through n— 1 



Notes 

*For block structure details, see "Assembler-Symbol Record/User Buffer Format Details". 



•'Symbol value as assigned by assembler. If a relocatable value it will be relocated by the linker. 



Figure 8-26. Assembler Symbol Record Structure 
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ASSEMBLER SYMBOL FILE 



DEFINITION BLOCK FORMATS 



Word 

_l_ 15 



8 . ^ 



First 
Sym. 
□ef 
BIk. 
(2 to 
10 
words) 



Sec 
Sym 
Del. 
BIk. 



L2 



0 


1 

(ID WORD = 6) 


I ' 

0 111 


— I- 

1 0 
1 






1 








15 13 


12 10,9 8 


7 




0 


SL 


0 0 0 1 R 


ASCII 1 






1 








15 


8 


7 




0 


ASCII 2 


ASCII 3 






1 










• 
• 
• 




• 
• 




15 


8 


7 




0 



ASCII 14 



ASCII 15 



Sym. Value (LS 16 sets) 
1 1 



15 



Sym Value 



8 7 

— H 



(MS 16 bits - if used) 



15 13,12 10,9 8 



SL 0 0 0 R 



ASCII 1 



ASCII 2 



ASCII 3 



Sym 2 Value 



(LS 16 bits) 



Sym. 2 Value (MS 16 bits - if used) 
1 I 



(n <127) 



Cfiecksum 



USERS BUFFER 



CONTENTS 


ADDR 


R/W Code 


CA 




#Words 


CA 


1 


15 8 


CA 


2 


7 0 


CA 


3 




15 


8 


7 


0 





9 (n1<257) 

Figure 8-27. Assembler Symbol Record/User Buffer Format Details 
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EXAMPLE A. SYMBOL = HP 



15 13 12 10 9 8 7 











SL=Number of 16-bit words - 1 


0 0 1 


0 0 0 


Relo 


ASCII H 


required to define a symbol In 










example A, SL=2-1 or 1 


SL = 1 


Reserved 









\ 



ASCII P 



ASCII blank 



Must specify a blank 



■Reserved' indicates that tfiese 
bits are reserved for use by 
other program modules 



One 
Symbol 
Value 
Word 



4- 



Symbol value 



Only one 16-bit word is required to 
contain the value assigned by the 
assembler. Thus, only one is used. 



■ Relo —Memory type 
relocated to: 

00=ABS 

01=PROG 

10=DATA 

11=C0MN 



EXAMPLE B. SYMBOL = S 



One 
Symbol 
Word 



10 9 8 



0 0 0 


0 0 0 


Relo 


ASCII S 



SL 

Reserved' 
Relo 



SL-0 Reserved 



Same as 
defined for 
example A, 
above 



One 
Symbol 
Value 
Word 



1 

Symbol value 



Again, only one 16-bit word Is required to contain the symbol value. 
Thus, only one is used. 

Figure 8-28. Assembler Symbol Record/Symbol Definition Blocic Examples 
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Record 
Word # 



First Record 
Microprocessor 
Configuration. — 

(Fixed length, 
25 words.) 



Global Symbols 

First Record 

(Variable length. 
128 words, max.) 



23 

^y. 



's^(nS127)_ 



7 



Global Symbols 

Last Record 
(Variable length, 
125 words, max.) 



Program Names 

First Record 
(Variable length 
128 words, max.) 



> 



ri£127]_ 



(n£127)_ 



Program Names 

Last Record 
(Variable length, 
128 words, max.) 



\.('2£'2IL 



Contents 



Record Type ID Word = 1 



Microprocessor Name and ID Definition 
Block 



Checksum for this record. 



Record type ID word = 2 



Global Symbols Definitions 



Checksum for this record. 




Record type ID word = 2 



Global Symbols Definitions 



Checksum for this record. 



Record type ID word = 3 



Program Name Definitions 



Checksum for this record. 




Record type ID word = 3 



Program Name Definitions 



Checksum for this record. 



Figure 8-29. Linker Symbol File Overall Structure 
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Record 
Word # 



/ 



Microprocessor 
Name and 
ID Definition 

Block, 
{Fixed length: 
8 words) 



\ 



N 
A 
M 
E 



Record ID Word = 1 



Words 1 through 15 contain all zeros. 



15 13 12 



MNL 



IDL 



0 0 0 



ASCII 1 



Name < 9 characters, ID < 6 characters Name 
and ID words must be packed within this block. 
All unused words must be at the end of this 
block. Unused last (LS) bytes must contain 
ASCII blanks (Code 20H), 



ASCII 14 



ASCII 15 



Checksum for this record. 



16 



24 



Notes 

1. Words 1 through 15 are added so that word positions 16-23 in this name record contain the same data as do the 
corresponding word positions in the name records of the relocatable files. 

2. MNL = Number of 16-bit words-1 requiredtodefinethemicroprocessorname. At least one character in the "ASCII 
1" byte is required. Thus, with a one character name, MNL = 0, If all nine characters are used (5 words), MNL = 4. 

3. IDL = Actual number of 16-bit words required to define the user ID. If one word is used, IDL = 1. If all three words 
are used, IDL = 3. 

4. Bits 10, 9, and 8 always contain 000. 

5. ASCII bytes 1-15 contain the name and ID characters. These words must be packed. That is the ID words must 
follow the name words. Unused words must be at the end of the block. An unused byte ineitheranameor ID word 
must contain an ASCII blank (Code 20H). 

6. The checksum contains the arithmetic sum of the binary values of words 0 through 23. 



Figure 8-30. Microprocessor Configuration Record Structure 
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GLOBAL SYMBOLS RECORD 



Record Type 



First Symbol 
Definition Block. 
Variable length 
from 2 words 
min. to 10 
words max. 



/ 



> 



Second Symbol 
Definition — 
Block* 



Word # 



Contents 



ID Word = 



Symbol word or words Identifies 
symbol characters and where they 
are relocated. 
(LI = 1 to 8 words) 



Symbol value" 



(L2 = 1 or 2 words) 



Symbol and value words 



Identifies Global Symbol 
Record in Linker Sym. File 



Symbol and value words 
must be packed If 
only one of each is required, 
then only two are used in 
the definition block. 



LS 16-bit 
word 



MS 16-bit — MS word is 
word used only if 

__ required to 

specify symbol 

value. 




Contains the 
arithmetic sum of 
the binary values 
of words 0 
through n-1. 



Notes 

"For block structure details see "Global Symbols Definition Block Diagram." 

**Symbol value assigned by assembler. If relocatable value (not ABS), it will be relocated by the linker. 

Figure 8-31. Global Symbol Record Structure 
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Symbol 
Definition 
Block. 
Length 
variable 
from 2 
to 10 
words. 
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Value assigned by linker (LS 16 bits) 



Value assigned by linker (MS 16 bits — if used) 



1 (min.) 

2 (max.) 



Notes 

1. GSL = Number of 16-bit words -1 required to define a global symbol. At least one character is required in the 
"ASCII 1" byte. Thus, with a one character name, NL = 0. If all 15 characters are used (8 words), NL = 7. 

2. Bits 12, 11, 10 are reserved for use by other program modules and always contain 000, 

3. "Relo" contains the binary code for area relocated to as follows: 00= ABS, 01 = PROG, 10 = DATA, and 11 =COMN. 

4. The bytes labeled ASCII 1-15 are the maximum number of bytes available to define the symbol. Only the actual 
number of 16-bit words required to define the symbol will exist. However, if the first byte (MSB) is used, then the 
second byte (LSB) must contain an ASCII blank (code 20 H). 

5. The symbol value is assigned by the assembler. If a relocatable value it will be relocated by the linker. 

Figure 8-32. Global Symbol Definition Block 
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PROGRAM NAME RECORD 



Word 
# 



First — 
Program Name 
and Addresses 
Definition 

Block." 



Second — 
Program Name 
and Addresses 

Definition 
Block* 



Contents 



ID Word = 3 



Program Name and ID. Name < 9 

characters. ID < 6 characters. 

Name and ID words must be packed. 

Unused words must be at ttie end of this 

block. 



PROG. DATA, and COMN load 
addresses. (Addresses not used will 
contain all 0's.) 



Program Name 



Program ID 



PROG, DATA, and COMN load 

addresses. 



Identifies Program Name 
Record in Linker Sym. File 



Fixed Length Block. 
14 Words. 

Words not required 
will contain 

meaningless informatron 
and must be at the 
end of the block. 



_ Fixed length block. 
14 words 



(n<127) 




Contams the arithmetic 
sum of the binary 
values of words 
4 through n-1. 



Notes 

"For block structure details, see figure 8-34. 



Figure 8-33. Program Name Record Structure 
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Program 
Name and 
Addresses 
Definition 
Block. 
Length 
Fixed 
14 Words, 



N 
A 
M 

E 



15 13 



PNL 



12 



IDL 



10 



Disc 



ASCII 1 



Name < 9 characters. ID < 6 characters. Name 
and ID words must be packed within this block. 
All unused words must be at the end of this 
block. Unused last (LS) bytes must contain 
ASCII blanks (code 20H). 



ASCII 14 



ASCII 15 



PROG area 


15 


LS 


PROG address word 


0 


9 


load address 


31 


MS 


PROG address word 


16 


10 


DATA area 


15 


LS 


DATA address word 


0 


11 


load address 


31 


MS 


DATA address word 


16 


12 


COMN area 


15 


LS 


COMN address word 


0 


13 


load address 


31 


MS 


COMN address word 


16 


14 



Block 
Word # 



1 \ 



Fixed 
- Length 
Block 



Notes 

1. PNL = Number of 16-bit words— 1 required to define the program name. At least one cliaracter in the "ASCII 1"byte 
is required. Thus, with a one character name, PNL = 0. If all nine characters are used (5 words), PNL = 4. 

2. IDL = Actual number of 16-bit words required io define the user ID. If one word is used, IDL = 1. If all three words 
are used, IDL = 3. 

3. DISC = The identifying number of the disc upon which the program resides. 

4. ASCII bytes 1-15 contain the name and ID characters. These words must be packed. That is - the ID words must 
follow the name words. Unused words must be at the end of the block. An unused byteineitheranameor ID word 
must contain an ASCII blank (Code 20H). 

5. Load Address Words - The load address words contain the load address assigned by the linker to this program. 
Unused address words contain all zeros. 



Figure 8-34. Program Name and Address Definition Block Format 
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15 File Structure 0 






0 


First Record 






Contains up to 128 16-bit 






words with 2 ASCII bytes/word 








n 




(n<127) 




0 


Second Record 






Same as first record. 








n 




(n<127) 


1 

etc 





■\ 



Variable length 
— 128 words 
max. 



Variable length, 
— 128 words 
max. 



Figure 8-35. Source and Listing Files - Overall Structure 



SOURCE FILE FORMAT 



USERS BUFFER 



WORD # WORD DATA 



Two ASCII 
Bytes 



1 Two ASCII 

Bytes 



FORMAT 



15 




A 


7 




0 




ASCII 1 


—\ 


h- 

h- 


ASCII 


2 




1 










15 




A 


A 




0 




ASCII 3 






ASCII 


4 



^ CONTENTS 


ADDR 




R/W Code 


CA 




» Words 


CA+1 




15 (ASC 1) 8 


CA^2 




7 (ASC 2) 0 


CA*3 




15 



Two ASCII 
Bytes 



ASCII 



ASCII y 




Figure 8-36. Source and Listing File Format 
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File Structure 



First Record 



Specifies data width base and 
transfer address. 



Second Record 



Specifies ** of data bytes in 

this record, and load address 

for record followed by data words. 



Third Record 



Same as second record 



Record 
Word t* 



_ Fixed length. 
4 words 



Variable length 
128 words, max. 



(n<127) / 



(n-127) 



Variable length. 

128 words, max 



Figure 8-37. Absolute and PROM Absolute File - Overall Structure 
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ILLUSTRATION A. 
RECORD 1 FORMAT ONLY, 
(Format for all Other Records Shown on Illustration B) 



USER BUFFER 



^ ABSOLUTE FILE RECORD 1 FORMAT'- 

Word # Word Data FORMAT 



0 Data Bus"" 
Width 



15 



1 Data Widtti 15 
Base" 



2 Xfer Address 15 
LS Word"- 



3 Xfer Address 
MS Word"' 



23 



1 r 



CONTENTS ADDR 





R/W Code 


OA 


# Words" t 


CA+I 


15 


8 


CA+2 


7 


e 


CA+3 








15 


8 


CA+4 


7 0 


CA+5 








15 


8 


CA+6 


7 


0 


CA+7 



31 


24 


CA+8 


23 


16 


CA*9 



Checksum ft 



\ 



32-BIT 
ADDRESS 

ALL ZEROS 
FOR PROM- 
ABSOLUTE 
FILES. 



Notes 

'Record 1 must precede all other records in an absolute file and it must always be formatted as shown. 
(Always four words.) 

"The Data Width Base is the minimum addressable entity (i.e., group of bits) used by the microprocessor. 
Normally this will be 8 bits but not always. 

***The transfer address is the value loaded into the microprocessor program counter. 
This value is all zeros for PROM Absolute files. 

•""Width of processor data bus (i.e., 8, 16 etc.) 

t Total number of words in record excluding checksum and number of words, (i.e. n-2), always equal to 4 for 
record 1. 

ft The checksum is the module 256 sum of bytes CA-l-2 through CA-l-9. 

Figure 8-38. Absolute and PROM Absolute File Formats 
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ILLUSTRATION B. 
FORMAT FOR ALL RECORDS EXCEPT RECORD 1 
(See Illustration A for Record 1 Format) 



-ABSOLUTE FILE RECORD FORMAT • 
FOR ALL RECORDS EXCEPT #1 



USER BUFFER 



1 r 



128 Words Max 



Word # Word Data 



0 « Data 
Bytes 



1 Load Addr 
LS Word' 



2 Load Addr 
MS Word 



3 Data Word 1 



3+m Data Word m 



15 



Format 
1 





BYTE 1 BYTE 2 
1 1 



BYTE y" 



31 


24 


CA+6 


23 


16 


CA+7 



32 BIT 
'ADDRESS 




Note 

"The load address Is the address of the first location into which this record is stored. 

"This last byte will be a pad byte if the record contains an odd number of bytes. This is required to fill up the 
word boundary. 

***The checksum is the module 256 sum of bytes CA+2 through N-1. 

Figure 8-38. Absolute and PROM Absolute File Formats (Cont'd) 
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Word 
# 



First Record 
Program 
Description 
(Variable length, 
128 words, max.) 



Global Symbols 
First Record 
{Variable length, 
128 words, max.) 



Global Symbols 
Last Record 
(Variable length, 
128 words, max.) 



Data Block 
First Record 
(Variable length, 
128 words, max.) 



Data Block 
Last Record 
(Variable length, 
128 words, max.) 



(n<127) 



V (n<127) 

0 ~ 



(n<127) 



(n<127) 



External Symbols 
First Record 
(Variable length, 
128 words, max.) 



External Symbols 
Last Record 
(Variable length, 
128 words, max.) 



(n<127) 



- 1 



\ (n_^27) _ 

/ 0 " 



Local Symbols 
First Record 
(Optonal) 
(Variable length, 
128 words, max.) 



Local Symbols 
Last Record 
(Optional) 
(Variable length, 
128 words, max.) 



End 
Record 
(Fixed length, 
5 words) 



- I 



{n<127) 



V _(£S127)_ 
7~ 0 

1 

i 

4 



Contents 



Record ! D word ^ 1 



Program Description Block 



Checksum for this record 



Record ID word = 2 



Global Symbols Definitions 



Checksum for this record 



Record ID word = 2 



Global Symbols Definitions 



Checksum for this record 



Record ID word = 3 



Checksum for this record 



Record ID word = 3 



Checksum for this record 



Record ID word = 4 



External Symbols Definitions 



Checksum for this record 



Record ID word ^ 4 



External Symbols Definitions 



Checksum for this record 



Record ID word = 6 



Local Symbols Definitions 
(Optional) 



Checksum for this record 



Record ID word = 6 



Local Symbols Definitions 
(Optional) 



Checksum for this record 



Record ID word = 5 



Checksum for this record 



\ 



These records can 
be in any order, 
_ but external symbols 
must come before 
they are referenced 
in data records. 



Figure 8-39. Relocatable File Overall Format 
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Identifies Program ^ 
Deseription Record in^^ 
Relocatable File ^ 



Source 
Program 
Name and 

Length- 
Definition 
Block 
Length 
Fixed 
14 Words 



PROG area 
length 



DATA area 
length 



Number of Externals 
Definition Block 



COMN area 
length 



0< No. < 512 



Microprocessor 
Name and 
ID Definition _ 

Block 
Length Fixed 
8 Words 



Date and Time 
Block 
Length Fixed 
2 Words 



Comments 
Definition 
Block - 
Length Fixed 
11 Words 



Absolute Code 
Segment 
Description Block _ 
Length Variable 
0 - 88 Words 

Contains the 
Arithmetic Sum of the 
Binary Values of 
Words 0 through n-1. 



Record ID word = 1 



PNL I IDL I DISC I ASCII 1 



SOURCE PROGRAM 
Name <9 characters. ID <6 characters. Name 
and ID words must be packed within this block. 
All unused words must be at the end of this 

block. Unused last (LS) bytes must contain 
ASCII blanks (Code 20H). 



ASCII 14 



PROG length 



31 MSW 



PROG length 



16 



DATA length 



31 MSW 



DATA length 



COMN length 



31 MSW 



COMN length 



No. of Externals 



MICROPROCESSOR 
Name ^9 characters. ID <6 Characters. Name 
and ID must be packed within this block. 
All unused words must be at the end of this 
block. Unused last (LS) bytes must contain 
ASCII blanks (Code 20H). 



ASCII 14 



ASCII 15 



Date 



Time 



ASCII 1 

COMMENTS BLOCK 
Comments <22 characters. Must be 
packed within this block. All 
unused words must be at the end 
of this block. Unused last (LS) bytes 
must contain ASCII blanks (Code 20H). 



ASCII 2 



ASCII 21 



ASCII 22 



Start Org 



MSW 



Start Org 



End Org 



End Org 



Checksum for this record 



36 



(<127) 



NOTES: 

1. 



PNL and MNL = Number of 16-bit words-1 required to define program or microprocessor name. At least one character in the 
"ASCI1 1" byte is required. Thus, with a one character name, PNL or MNL = 0. If all nine characters are used (5 words) PNL or 
MNL = 4. 

IDL = Actual number of 16-bit words required to define the user ID. If one word is used, IDL = 1. If all three words are used IDL 

= 3. 

Disc (in program name segment) - The identifying number of the disc upon which the program resides. 
Bits 10, 9, and 8 in microprocessor name segment always contain 000. 

ASCII bytes 1-15 contain the name and ID characters. These words must be packed. That is; the ID words must follow the 
name words. Unused words must be at the end of the block. An unused byte in either a name or ID word must contain an ASCII 
blank (Code 20H). 

Length bytes or words - Contains the number of bytes or words (processor dependent) of code produced by the assembler or 
compiler in each of the three relocatable sections: PROG, DATA, COMN. 

Number of externals - Contains the number of external variables and procedures defined in the module. 

Comments - Contains up to 22 ASCII characters defined by the NAME psuedo in the assembler or compiler. All unused 

characters must contain ASCII blanks (Code 20H). 

Absolute code segment description - Contains 0 to 22 entries of four 16-bit words. Each four word entry defines an absolute 
code segment declared in the assembler or compiler. 

Figure 8-40. Relocatable File Program Description Definition Block 
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Identifies Data 
Record 
Relocatable File 
Defines Relocation 
Address 
Identifies Fiie Type 
Destination of Relocation 
Identifies Events 
to Follow 





Record ID word = 3 


0 


Relocation 


15 


LSW 


Relocation Address 


e 


1 


address area 


15 


MSW 


Relocation Address (if used) 


0 


2 




Relocation 


3 


Event selection area 


T1 




T3 1 T4 1 T5 1 T6 1 T7 


XB 


4 



NOTE 

Event and order of the 

following events are selected by event 

selection, above (see notes). 



Words or Word 
Groups Selected 



Events to 
Follow Word 4 



Contains the 
Arithmetic 
Sum of the 
Binary Values 
of Words 
0 through n-1 



-c 



Checksum for this record 





Tn = 00 




Don't Care | Low Byte 






15 


8 7 0 




Tn = 01 




Higti Byte | Low Byte 






16 


8 7 6 0 






1 Relo 1 Format No. 




Tn = 10 


LSW 


Unrelocated Address 




MSW 


Unrelocated Address (Optional) 






Optional Skeleton 






15 


7 6 0 






External ID No | Format No. 




Tn = 11 


LSW 


Signed Displacement 




MSW 


Signed Displacement (Optional) 






Optional Skeleton 



I (<127) 



NOTES: 

1. Relocation Address Words - The relocation address words contain the relocation address assigned by the 
linker to this program. The MSW is used only when the ID offset = 3. 

2. Relocation contains the binary code for area relocated to as follows: 00 = ABS, 01 =PROG, 10 = DATA, and 11 
= COMN. 

3. Event Selection Area - Selects events to follow. T1 through T8 may contain any one of codes 00, 01, 10, or 11. 
Codes are defined as follows: 00 = one byte absolute with no modifications, 01 = two bytes absolute with no 
modifications, 10= relocatable reference, and 11 = external reference. As T1 through T8 are read, the event 
selected by the specific code will be executed. 

4. Tn = 00 - Produce one byte of absolute code, which is found In the low order byte of the corresponding word. 

5. Tn = 01 - Produce two bytes of absolute code, which Is found in the corresponding word. 

6. Tn = 10 - relocate the address to be found in the second word (and optionally, the third word) based on the 
relocation code in the first word. Then produce an absolute code based on the processor dependent format 
number in the first word and skeleton, if present. 

7. Tn = 1 1 - look up the external symbol whose number is in the first word (which has been previously defined in a 
type 4 record). Add the displacement and then produce an absolute code based on format number and 
optional skeleton. 

Figure 8-41. Relocatable File Data Definition Block 
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Identifies External 
Symbols Record 
in Relocatable File 



< 



First - 
Symbol Definition 
Block, Length 
Variable From 
2 to 9 Words 



Contains the 
Arithmetic Sum 

of the Binary 
Values of Words 
0 through n-1. 



Last . 
Symbol Definition 
Block, Length 
Variable From 
2 to 9 Words 



< 



s 

Y 
M 
B 
O 
L 



S 
Y 
M 
B 
O 
L 



Record ID word ^ 4 



0 0 10 0 



ASCII 1 



Symbol <15 characters. ASCII 1 
must contain character. For all 
others, unused last (LS) byte must 
contain ASCII blank (Code 20H). 



ASCII 14 



ASCII 15 



External ID Number 




ASCII 1 



Symbol <16 characters. ASCII 1 
must contain character. For all 
others, unused last (LS) byte must 
contain ASCII blank (Code 20H). 

ASCII 14 , ASCII IE 



External ID Number 



Checksum for this record 



n 

(<127) 



NOTES: 

1 . ESL = Number of 16-bit words required to define an external symbol. At least one ctiaracter in the ASCI1 1 byte 
is required. Thus, with a one character definition, ESL = 0. If all 15 characters are used (8 words) ESL = 7. 

2. Bits 8 through 12 always contain 00100. 

3. The bytes labeled ASCI1 1-15 are the maximum number of bytes available to define the symbol. Only the actual 
number of 16-bit words required to define the symbol will exist. However, if the first byte (MSB) is used, then 
the second byte (LSB) must contain an ASCII blank (Code 20H). 

4. External ID Number is assigned by the assemnbler or compiler. ID number is <511. 



Figure 8-42. Relocatable File External Symbols Definition Block 
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Identifies End 
Record in Relocatable 
File 

Defines 
Transfer Address 

Identifies Relocation 

Destination 

Contains the Arithmetic 
Sum of the Binary 
Values of Words 
0 through 4 



Transfer 
address area 



LSW 



Record ID Word^S 



Transfer Address 



Transfer Address 



Checksum for this record 



Notes: 

1. Relocation-contains the binary code for area relocated to as follows: 00=ABS, 01=PROG, 10=DATA, 
11=C0MN, 100-No transfer address. 

2. Transfer Address Words-Contains the address where control will be transferred to when the program is run. 
Only one module in a program may have a transfer address, and it is defined in the END label psuedo in the 
assembler or the presence of the main program block in a PASCAL module. 



Figure 8-43. Relocatable File End Definition Block 
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Appendix 



Syntactical Variable Definitions 

The syntactical variables used throughout this manual are described in this appendix. 
<ABSFILE> 

The <ABSFILE> is the file identifier of an absolute file that contains the emulation program. 
The emulation program is placed into the file by assembling and linking to the file before 
application to the target microprocessor. <ABSFILE> has the same format requirements as 
the <FILE> variable which is described later in this appendix. 

<ADDRESS> 

The <ADDRESS> variable defines a bit pattern of up to 16 bits which specifies a particular 
location in mapped memory. That bit pattern can be represented by a binary, octal, 
hexadecimal, or decimal number; a local or global symbol; or a mathematical combination of 
numbers or symbols. <ADDRESS> has the same format requirements as the <VALUE> 
variable which is described later in this appendix. 

<ADR_LST> 

The variable <ADR_LST> contains a list of addresses, separated by commas, where the 
addresses are within the address space defined by the processor. 

<CMDFILE> 

The <CMDFILE> variable is the file identifier for an existing emulation configuration file. This 
command file contains the organizational commands for the processor to be emulated. The 
command file can be retained or modified for further use. <CMDFILE> has the same 
requirements as the <FILE> variable which is described later in this appendix. 
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<FfLE> 

The <FILE> variable is used to identify files generated or accessed by the development 
system commands. <FILE> consists of the following parameters: 



where: 



<FILE NAME>[:<USERID>][:<DISC#>] 



<FILE NAME> 



is the identifier given to a particular file. <FILE NAME> must begin 
with an upper case alphabetic character and can have a total length 
of nine characters. After the first character, any upper or lower 
case alphanumeric character or an underscore can be used. If 
more than nine characters are specified, the name is truncated to 
the first nine characters. 



<USERID> 



is the identifier assumed by a particular system user. <USERID> 
must begin with an upper case alphabetic character and can have a 
total length of six characters. The characters following the first 
character can be any upper or lower case alphanumeric 
characters, including the underscore. If more than six characters 
are specified, the userid is truncated to the first six characters. If a 
userid is not entered, the current userid is used as the default. 



<DISC#> specifies the disc on which the file is stored. <DISC#> can be any 

digit from 0 thru 7, but it must correspond to the Logic Unit number 
assigned to one of the discs at system power up. The default is to 
search the discs for the file specified, or to create the file on disc 
zero. 

<REAL_VAL> 

The <REAI VAL> variable is an alphanumeric representation of a real number value. The 

syntax is: 

I + I I .<integer> [El[-])<in,ege,>]| 

(L-J) <inteqer> < 



|^+j|<integer> 



Where <integer> is an unsigned decimal integer. 
<STATE> 

The <STATE> variable specifies a particular state on the emulation bus. The <STATE> 
expression consists of an address, a data, and a status specification. 
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<VALUE> 

<VAHJE> is a syntactical variable that allows specification of symbols (labels), numbers, 
parentheses, and math operators (+, - /, (), *) following standard algebraic rules to produce a 
value. Legal operands are defined as follows: 

<NUMBER> is an alphanumeric representation of a 16 bit pattern of ones, zeros, 

and don't cares (X's). The bit pattern can be represented in binary, 
octal, hexadecimal, or decimal where binary is indicated by a "B", 
octal by a "Q", hexadecimal by an "H", and decimal by a "D". 
Decimal is the default value and the use of "D" is optional. 

Examples: 

(A+B)*C 

1010101 1XXXXXXXB 

145XXXQ 

2563 

The <LOCAL SYMBOL> variable represents the name of a symbol which can only be 
used by the program module in which it is defined. The <GLOBAL SYMBOL> variable 
represents the name of a symbol which can be called by program modules other than 
the one in which it is defined. The global symbol must be declared as such by a GLB 
statement in the source file. 

<LOCAL SYMBOL> is specified as: SYMBOL-NAME [:<MODULE>] or: #<LINE #> 
[:<MODULE>] where <MODULE> is the same as <FILE>. For 
PASCAL programs, lines which generate object code produce 
local line # symbols corresponding to the source line. 

<GLOBAL SYMBOL> is specified as <SYMBOL_NAME> or :<MODULE> which 
produces the starting address of the specified <MODULE>. 

<MODULE> specifies the file in which the local symbol is defined. If no 

<MODULE> is specified, the global symbol table associated with 
the absolute program file loaded by the emulator is searched for 

the <SYMBOI NAME>. If the symbol name is not found in the 

global symbol table, a search is made of the last referenced local 
symbol table. If the symbol name is not found in the local symbol 
table, an error message is displayed on the status line. For more 
information, refer to the description of <FILE> which is included in 
this appendix. 
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<STRING> 



is an ASCII string delimited by ", ', and produces a 16 bit code. 



Examples: 



"A" 00000041 H 
'AB' 000041 42H 
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Appendix 



6809/6809E Status and 

Error Message 



status Messages 

Access to guarded memory, address OXXXXH - Guarded memory is accessed by the 64000 
station through display memory or modify memory commands. OXXXXH is the address 
in guarded memory. 

Breal< in bacl<ground - A breal< has occurred and the emulator processor is executing in the 
background program. See chapter 2 for details on "break". 

Break unknown state - Control of the emulator processor is lost. A reset command should be 
issued to recover the processor. 

Dma request (,no memory cycles) - The direct memory access line is pulled low by the target 
system (*DMA/BREQ = 0, BA = 1). 

Halt (,no memory cycles) - The halt line is pulled low by the target system (*HALT = 0). 

Memory wait - The memory ready line is pulled low by the target system (MRDY = 0). 

No memory cycles - The processor has not done a valid memory cycle during the last 500ms. 

Reset in background - A reset command has been issued by the 64000. The emulator 
processor is in background. 

Reset unknown state - Control of the emulator processor is lost. A reset command should be 
issued to recover the processor. 

Reset (,no memory cycles) - The reset line is pulled low by the target system (*RESET = 0). 
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Running - The emulator processor is running in foreground. See chapter 2 for details on 
"foreground". 

Step complete - Single-stepping was successfully completed. 

Step in process - The emulator is single-stepping through target program. 

Sync ack (,no memory cycles) - SYNC instruction was executed, the emulator processor is 
now in a synchronizing state, all instruction processing is stopped, and the processor 
is waiting for an interrupt (*DMA/BREQ = 0, BA = 1). 

Waiting for interrupt - CWAI instruction was executed, the emulator processor is. waiting for 
an interrupt (BA = 0). 

Error Messages 

Command causes break, runs restricted to real-time - If the emulator is running and "restrict 
to real-time only" was specified in the configuration, commands that will cause the emulator 
to alternate between target program and background program are not allowed, i.e., display 
registers, modify memory, etc. See chapter 4 for details on real-time restrictions. 

Command not allowed, processor not in background - The command requires the emulator 
processor to be in background. An attempt has been made to break the processor, but was 
not successful. The emulator will recover to a "break in background" state once the break has 
succeeded. 

Illegal memory access PC=OXXXXH - An illegal memory access by the emulator processor 
has occurred during execution of user code (write to ROM or access to guarded memory). 
PC=OXXXXH is the address of the last opcode to be executed by the emulator processor 
before the illegal memory access. This type of error detection is possible only when a 
memory control board is part of the emulation subsystem. 

Illegal opcode OXXH at OXXXXH - An illegal opcode was executed by the emulator processor. 
The opcode and the opcode address are displayed in the message. 
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Appendix 



Radio Frequency Interference 

With an emulation system installed in the Model 64000, several methods of operation 
(physical setup) may result in an increased emission of radio frequency noise. To reduce the 
r.f. noise level, any of the following techniques may be used: 

a. When the emulator is used infrequently, disconnect the emulator pod and cables from 
both the host system and target system. 

b. For systems that use the emulator intermittently, select "external clocl<" and 
disconnect the pod cable from the target system when not in use. 

c. Consistent with design needs, minimize the time that the emulator is used without 
being connected to a target system. 

d. All 64000 system covers should be in place and properly attached to the mainframe (all 
housing screws tight). 

e. Emulator performance verification is a service tool. Minimize its usage consistent with 
performance assurance. 



NOTE 



Running the emulator while connected to a target system 
should produce little additional r.f. noise above that generated 
by the target system itself. 
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Emulator Electrical Properties 



The emulation equipment, when connected to a target system, will respond similarly to the 
microprocessor it emulates. The timing of the processor signals at the probe closely 
approximates the timing of the microprocessor normally inserted in the same plug. Voltage 
and current requirements for the drive and receive circuitry of the emulator are generally 
equivalent to LS TTL specifications. The capacitive loading of the emulation probe is 
equivalent to the LS TTL gate capacitance plus the capacitance of the probe cable, which is 
approximately 20 pF. 

Some critical emulator signals may exhibit characteristics different than explained above. 
The operating manual supplement for your emulator should be referenced for details on 
these signals. 



The emulation pod presents greater drive capability and 
slightly greater capacitive loading to the target system than 
the processor being replaced. Consequently, it is conceivable 
that a user's system, which operates under emulation, may 
not operate properly when driven by a microprocessor IC. 
Noise margins and signal levels in marginally overloaded 
designs may not cause problems when driven by emulation 
but may be fatal to system operation under normal 
microprocessor drive conditions. Be sure that your design 
allows for the added drive and loading specifications of the 
64000 emulation pod. 



NOTE 



EMULATOR/ANALYZER 6809/6809E 



D-1/(D-2 blank) 



INDEX 



<ABSFILE> . . . , 4-6, A-1 

<ADDRESS> A-1 

<ADR_LST> A-1 

<BREAK> 7-2, 7-5 

<CMDFILE> 5-3, 5-21, A-1 

<CMD_FILE> 4-4 

<COUNT> 7-2, 7-5 

<DISC#> A-2 

<FILE NAME> 4-14, A-2 

<FILE> A-1 

<GLOBAL SYMBOL> A-3 

<LOCAL SYMBOL> A-3 

<MODULE> A-3 

<NUMBER> 5-22, A-3 

<OFFSET> 6-13 

<QUALIFIER> 7-2, 7-4 

<RANGE_STATE> 7-2 

<REAL_VAL> A-2 

<STATE> A-2 

<STATUS_IDENT> 7-3 

<STRING> A-4 

<TRIGGER> 7-2, 7-4 

<USERID> A-2 

<VALUE> 7-2, A-3 

a 

A 3-1 

ASCII string delimiter A-4 

Absolute File 4-2, 4-6, 8-86 

Absolute time, count 7-5 

Access to guarded memory B-1 

Accessing an existing file, disc I/O.... 8-27 

Address bus width selection 1-5 

Address jumper plug 1-7 

Address range selection 1-7 

Aft_xfer bit 3-4 

Aft_xfr 3-6 



Again 7-5 

Analysis and interactive commands 7-1 

Analysis board 1-2, 1-5 

Analysis commands 7-4 

Analysis, functional description 2-4 

Analyzer characteristics 2-12 

Analyzer status 2-13 

And function 7-4 

Asmb_sym 4-1, 6-10 

Assembler symbols file, format 8-79 

Assembly 4-1 

b 

B 3-1 

BNC ports 7-1 

BSR 3-5 

Background controller 2-6, 2-7 

Background controller transition 2-7 

Background memory 2-5, 4-8 

Background state 2-4 

Baud rates 8-39 

Break 2-6, 5-2, 7-5 

Break in background 2-5, B-1 

Break on measurement complete... 2-6, 7-2 

Break on trigger 2-6 

Break unknown state B-1 

Break, sources of 2-6 

Bus grant 3-9 

Bus orientation, 64000 Logic development 

station 2-1 

Bus, HP-IB 2-2 

Bus, I/O 2-2 

Bus, emulation 2-1 

Bus, host processor 2-1 

Bus, intermodule 1-9, 2-2, 7-15 

Bus, system 2-1 



EMULATOR/ANALYZER 6809/6809E 1-1 



c 



CA 8-8 

CC 3-1 

COMM program counter 4-2 

COMN 6-5 

CWAI instruction 3-2, B-2 

Cable placement, 641 OOA card cage 1-9 

Cable placement, 6411 OA card cage 1-9 

Cable, address bus width 1-5 

Cable, emulation bus 1-8 

Cable, emulation control 1-3 

Cable, intermodule bus 1-9 

Cable, memory bus 1-9 

Capacitive loading, emulation probe D-1 

Card selection 4-7 

Changing the file name, disc I/O 8-29 

Clock selection 2-11, 4-7 

Clock specifications 2-11, 3-11 

Clock, external 2-11 

Clock, internal 3-11 

Clock, internal emulation 2-11 

Close display file 8-13 

Close printer file 8-9 

Command causes break B-2 

Command delays 5-22 

Command file designation 4-14 

Command file, linker 8-24 

Command not allowed B-22 

Command to 8251 8-40 

Command word codes, keyboard 8-22 

Comment delimiter, command line 5-1 

Common attributes, simulated I/O 

interfaces 8-2 

Configuration questions 4-6 

Configuration, emulation 1-2, 2-11, 4-6 

Configuration, emulation probe pod 3-7 

Configuration, emulator 2-11 

Configuration, hardware 1-1 

Configuration, interactive measurement 4-14 

Configuration, memory 4-9 

Configuration, simulated I/O 4-12 



Continue option 4-3, 4-5 

Control addres ... 4-12, 4-13, 4-14, 8-2, 8-8 

Count mode, absolute 2-13, 6-15, 7-5 

Count mode, relative 2-13, 6-15, 7-5 

Creating a new file, disc I/O 8-26 

d 

D 3-1 

DATA 6-5 

DATA program counter 4-2 

DMA 3-2, 3-7 

DMA bit 3-4 

DMA line 3-9 

DMA transaction 3-6 

DMA/BREQ 3-3 

DP 3-1 

Data jamming 2-6 

Default responses 4-6 

Delay clock 7-8 

Deleting a file, disc I/O 8-29 

Direct memory access 3-8 

Disc file I/O interface codes 8-32 

Disc file type numbers 8-30 

Disc files simulated I/O 8-4, 8-24 

Display I/O interface 8-3, 8-11 

Display I/O interface codes 8-14 

Display and list command capabilities .. .6-1 
Display and list command syntax ..6-1, 6-6 

Display and list commands 6-1 

Display command 2-13, 6-7 

Display count 2-13, 6-14 

Display, simulated I/O 8-3, 8-11 

Display/list 6-7 

Display/list count 6-8, 6-15 

Display/list global-symbols 6-9 

Display/list loc_symb 6-10 

Display/list memory 6-1, 6-11 

Display/list real number 6-3 

Display/list registers 6-13 

Display/list trace 6-14 

Dma 3-6 
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Dma request (,no memory cycles) B-1 

Dma_transfer 3-6 

Don't care 7-4 

Drive 7-6 

e 

Electrical transparency 2-5 

Emul_com file 4-15 

Emulate 4-2, 4-4, 4-5, 5-3 

Emulate command 4-2 

Emulation and analysis, functional 

description 2-4 

Emulation and configuration 4-1 

Emulation command file 4-6 

Emulation considerations 3-2 

Emulation control board 1-3, 2-2, 4-3 

Emulation controller, functional 

description 2-4 

Emulation memory, functional 

description 2-9 

Emulation pod plug-in leads 3-7 

Emulation pod switches 3-11 

Emulation probe pod configuration 3-7 

Emulation probe, capacitive loading D-1 

Emulation processor 2-6, 3-1 

Emulation processor, control of 2-6 

Emulation, external 2-10 

Emulation, internal 2-10 

Emulator electrical properties D-1 

Emulator operating modes 2-10 

Emulator pod, 6809 series 1-3, 3-7 

Emulator pod, 6809E series 1-3, 3-7 

Emulator status 3-3 

End 4-6, 4-11, 5-3 

End command 4-2, 8-3 

Ending tine mapping session 4-11 

Error codes, simulated I/O 8-67 

Error messages B-2 

Execute 5-4 

Execution, emulation 4-6 

Exit background state 2-8 



External emulation 2-10 

f 

FUSER1 3-7 

FUSER2 3-7 

Fetch bit 3-4 

Fetch, vector 3-10 

File formats, 64000 8-79 

File linking 4-1 

File types, disc, predefined 8-26 

File, absolute 4-1 

File, asmb_sym 4-1, 6-10 

File, emulation command 4-6 

File, link_com 4-2 

File, link_sym 4-2, 6-9 

File, listing 8-86 

File, relocatable 4-1, 8-87 

File, source 4-1, 8-86 

File, system command 5-20 

Follows-transfer 3-6 

Foreground memory 2-6, 3-2 

Foreground operation 2-4 

Foreground state 2-4 

Functional transparency 2-5 

g 

GROUND 3-7 

Global symbols 6-9 

Global symbols record 8-83 

h 

HALT 3-3, 5-5 

HP-IB 2-1 

Halt (,no memory cycles) B-1 

Hdwr_int_serv 3-6 
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Hsr 3-6 

Hsr bit 3-4 



Interrupt, hardware 3-4 

Interrupt, software 3-2, 3-4 

lntr_vec 3-6 

lntr_vec bit 3-4 



MB connectors 7-5, 7-6 

MB functions, 40 channel analysis 7-7 

MB functions, 48 channel analysis 7-7 

NT VEC1 3-7 

NT VEC2 3-7 

die background 2-7 

llegal memory access B-2 

I legal opcode 4-9, B-2 

llegal opcode detection 4-9 

nitialize 8251 8-38 

nstallation 1-2 

nstallation, analysis board 1-5 

nstallation, bus cables 1-8 

nstallation, emulation control board 1-3 

nstallation, emulation pod 1-3 

nstallation, emulation probe 1-3 

nstallation, memory board 1-7 

nstallation, memory control board 1-5 

nstructions, call 3-5 

nstructions, control transfer 3-5 

nstructions, return 3-5 

nteractive commands 7-1 

nteractive measurement configuration. 4-14 
nteractive measurement selection .. 7-1, 7-5 

nterface, RS-232 I/O 8-4, 8-37 

nterface, development station 2-4 

nterface, disc file I/O 8-4, 8-24 

nterface, display I/O 8-3, 8-11 

nterface, keyboard I/O 8-3, 8-17 

nterface, printer I/O 8-3, 8-8 

nterfaces, subsystem 2-4 

nternal analysis board, 40 channel 

(64300A) 7-7 

nternal analysis board, 48 channel 

(64302A) 7-7 

nternal emulation 2-10 

nterrupt vector 3-4 



JSR 3-5 

Jam background 2-8 

Jam background, state 2-8 



KB-input-command word 8-22 

KB-output-command word 8-22 

Key, down arrow 6-3, 7-4 

Key, next page 6-3, 7-4 

Key, prev page 6-3, 7-4 

Key, roll down 6-3, 7-4 

Key, roll up 6-3, 7-4 

Key, up arrow 6-3, 7-4 

Keyboard I/O interface codes 8-20 

Keyboard, simulated I/O 8-3, 8-17 



LBSR 3-5 

LUSER 3-7 

Link_com file 2-12, 4-2 

Link_sym file 4-2, 6-9 

Linker command file 8-24 

Linker configuration file 8-24 

Linker symbols file 8-81 

Linking files 4-1 

List 6-7 

Listing file 8-86 

Load 2-7, 4-6, 5-6 

Local symbols 2-12, 6-5 
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Lost character 8-19 

m 

MRDY 3-3, 3-11 

Measurement system command syntax, 

multiple module 4-3 

Measurement system command syntax, single 

module 4-5 

Measurement-System 4-2 

Memory addresses, offset 6-12 

Memory boards 1-7 

Memory boards, 641 6X 1-7 

Memory configuration 4-9 

Memory contents, hexadecimal and 

ASCII 6-2 

Memory contents, mnemonic 6-3 

Memory control board 1-5 

Memory data 6-1 

Memory map 4-9 

Memory overlay 4-10 

Memory wait B-1 

Memory, RAM 4-9, 4-10 

Memory, ROM 4-9, 4-10 

Memory, available size 1-7 

Memory, background 2-5, 4-8 

Memory, emulation .2-11, 3-2, 4-10, 5-6, 6-1 

Memory, guarded 4-10 

Memory, target system 2-4, 2-1 1 

Memory, trace 2-12 

Memory, user 4-10, 6-1 

Microprocessors, 6809 Series 1-3, 3-1 

Microprocessors, 6809E Series 1-3, 3-1 

Mode command to 8251 8-40 

Modify 5-7 

Modify command 2-9 

Modify configuration 4-6, 5-9 

Modify interactive measurement 

specification 4-14, 7-5 

Modify memory 2-9, 5-10 



Modify register 5-12 

Modify simulated I/O 4-13 

Multi-module system architecture 2-3 

n 

NMI 3-2 

No memory cycles B-1 

Non-maskable interrupt 3-2 

Non-realtime emulation 2-10 

Non real-time 2-9 

Not_dma 3-6 

Not_dma_transfer 3-6 

Not_hdwr_serv 3-6 

Not_hsr 3-6 

Not_int_v 3-6 

Not- interrupt- vector 3-6 

Not-soft-serv 3-6 

Not_ssr 3-6 

Nxt PC 6-4 

o 

Offset 6-4, 6-12, 6-13, 6-15 

Opcode 3-6 

Opcode bit 3-4 

Open RS-232 File 8-37 

Open display file 8-11 

Open printer file 8-8 

Operating fundamentals 3-1 

Operating modes 2-10 

Operating modes, 8251 8-38 

Operational command syntax 5-1 

Operational commands 5-1 

Options continue 4-3, 4-5 

Options edit 4-5 

Output ports 3-10, 7-5 
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PC 3-1,6-4 

PROG 6-5 

PROG program counter 4-2 

Parms 5-21 

Pin protector, emulation probe 1-4 

Port 1 7-6 

Port 2 7-6 

Positive KB output command word detection, 

64000 8-18 

Power requirements 1-1 

Predefined file types 8-30 

Printer I/O interface codes 8-10 

Printer, simulated I/O 8-3, 8-8 

Processor architecture 3-1 

q 

Qualification, storage 7-4 

Qualification, trigger 7-4 

Qualifier, analysis 7-4 

r 

R/W buffers, RS-232 8-43 

R/W line 3-9 

RAM 4-9, 4-10 

RESET 5-3 

ROM 4-9, 4-10 

RS-232 4-12, 8-4 

RS-232 I/O interface codes 8-44 

RS-232 read buffer 4-12, 8-43 

RS-232 write buffer 4-12, 8-43 

RS-232, simulated I/O 8-4, 8-37 

RTI 3-5 
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RTS 3-5 

Radio frequency interference C-1 

Read 2-9, 3-6 

Read from 8251 8-42 

Read keyboard I/O 8-17 

Read memory 3-6 

Read/write bit 3-4 

Real-time 2-9, 6-5, B-2 

Real-time emulation 2-10 

Real-time selection 4-8 

Receive 7-6 

Register contents 6-4 

Register names 3-1, 3-2 

Relative time 2-13, 6-15 

Relocatable file 4-1, 8-87 

Repetitively 2-12, 5-4, 7-5 

Reset 5-13 

Reset (,no memory cycles) B-1 

Reset in background B-1 

Reset unknown state B-1 

Response to keyboard read request, 

64000 8-18 

Response, CA=00 8-19 

Restart- processor 3-3 

Roll to/write line 18 8-12 

Run command 4-6, 4-8, 5-14 

Running 4-6, B-2 

Running the emulator 2-11 

Running the program 4-6 

s 

S 3-1 

Sample programs, simulated I/O 8-68 

Select column 8-13 

Select line 8-13 

Shield, emulation control cable 1-4 

Simulate key 8-17 

Simulated I/O configuration 4-12 

Simulated I/O error codes 8-67 

Simulated I/O, introduction 8-1 



Simulated I/O, overview 8-2 

Single-stepping 2-8, 3-2 

Soft_int_serv 3-6 

Softkey labels 3-3 

Softkey, trace status 3-5 

Software interrupt instruction 2-5 

Source file 4-1, 8-86 

Specifications, clock 3-11 

Specifications, interactive measurement 4-14 

Specifications, softkey status 3-5 

Specify 5-16 

Ssr 3-6 

Ssr bit 3-4 

State transition 2-7 

State, exit background 2-8 

State, foreground 2-7 

State, idle background 2-7 

State, jam background 2-7 

Status bits 3-4 

Status byte format 3-3, 3-4 

Status from 8251 8-40 

Status messages B-1 

Status specification, numeric 3-3 

Status specification, soft key 3-5 

Status word format 8-59 

Status, analyzer 2-13 

Status, emulation analysis 2-13 

Status, emulator 3-3 

Step 5-17 

Step complete B-2 

Step in process B-2 

Stepping, continuous 2-8 

Stop_trace 5-18 

Store 5-19 

Subroutine calls 3-5 

Subroutine nesting 3-4 

Subroutine returns 3-5 

Switch, INTERNAL CLOCK 3-11 

Switch, MRDY 3-11 

Switch, data bits 1-5 

Switches, emulation pod 3-11 

Symbol definition blocks 8-83 

Symbolic referencing 2-12 



Symbols, global and local 2-12, 6-5 

Sync ack (,no memory cycles) B-2 

Sync instruction 3-9 

Syntactical variable definitions A-1 

Syntax, shorthand 7-3 

System bus structures 2-1 

System command file 5-20 

Systems, multi-module 1-2, 4-2, 7-1 

Systems, single module 1-2, 4-4 

t 

TSC 3-3 

Target System, components 2-4 

Target processor removal 1-3 

Target system memory 2-4, 2-1 1 

Theory of operation 2-1 

Trace 7-2 

Trace command 2-12 

Trace complete 7-4 

Trace file 5-19, 7-1 

Trace information 6-5 

Trace memory 2-12, 5-19 

Trace specifications 2-6, 2-12, 5-6, 7-4 

Trace status softkey 3-6 

Transfer instructions, control 3-5 

Transparency considerations 2-5 

Transparency, electrical 2-5 

Transparency, functional 2-5 

Trap loop 2-7 

Trigger 7-4 

u 

U 3-1 

Updating read buffers, RS-232 I/O 8-43 

Updating write buffers, RS-232 I/O 8-43 

User buffer/assembler symbols file packing 
formats 8-81 
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User buffer/linker symbols file packing 

formats 8-86 

User buffer/relocatable file packing 

formats 8-93 

User program keyboard read request.. 8-17 

User's program detects 00 in CA 8-19 

Using analysis commands 7-4 

V 

Vector Fetch 3-10 

w 

WROM1 3-7 

WR0M2 3-7 

Wait 5-22 

Waiting for interrupt 3-2, B-2 

Write 3-9 

Write from selected line/column 8-13 

Write memory 3-6 

Write operation to ROM 2-9 

Write to 8251 8-40 

Write to emulation memory 2-9 

Write to printer 8-9 
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